> ## Documentation Index
> Fetch the complete documentation index at: https://pomeroy.app/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Notes

> Your AI assistant can find a note, read it in full, and start a new one. It never edits, moves, or deletes an existing note.

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.

<Columns cols={2}>
  <div>
    **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
  </div>

  <div>
    **Cannot**

    * Edit an existing note
    * Delete a note or a folder
    * Move notes around
  </div>
</Columns>

## 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

```text theme={null}
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

<AccordionGroup>
  <Accordion title="Listing is deliberately cheap" icon="list">
    `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.
  </Accordion>

  <Accordion title="Bodies come back as plain text" icon="align-left">
    Formatting, tables and attachments do not survive. What an assistant reads
    is the words.
  </Accordion>

  <Accordion title="There is no edit tool" icon="pen-slash">
    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.
  </Accordion>
</AccordionGroup>

## 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.