Notes

Notes is where the additive rule is clearest: an assistant can add to your notes and read them, and it can never change one you already wrote.

Can

List your notes by name
Read one note in full, as plain text
Create a new note, in a folder you name if you like

Cannot

Edit an existing note
Delete a note or a folder
Move notes around

Tools

Tool	What it does	Kind
`notes_list`	Every note’s id and name, sorted by name. Bodies are excluded	Read
`notes_read`	One note in full, by id. The body comes back as plain text	Read
`notes_create`	Creates a note and returns it as saved, with its id	Write

Try it

Find my note about the boiler pressure.
What did I write down about the mortgage?
Start a note called Packing list with the things I said earlier.
Summarise my meeting notes from last week.

Worth knowing

Listing is deliberately cheap

notes_list returns names and ids only. An assistant that needs a body asks for that one note. A years-old Notes library does not arrive in your conversation because somebody asked a vague question.

Bodies come back as plain text

Formatting, tables and attachments do not survive. What an assistant reads is the words.

There is no edit tool

Rather than rewriting a note, an assistant can create a new one. Your original stays exactly as you left it, which for a notes app is the behaviour worth having.

Permissions

Switching Notes on asks macOS for permission to control Notes (NSAppleEventsUsageDescription). Automation is per app, so approving Notes says nothing about Mail or Shortcuts.

Pomeroy

Getting started

Features

Assistants

Guides

Configuration

Privacy and security

Licence and removal

Tools

Try it

Worth knowing

Permissions

​Tools

​Try it

​Worth knowing

​Permissions

Tools

Try it

Worth knowing

Permissions