- The app: write one yourself on the Notes page, or ask Igris, a chat session, or a workflow’s Brain to save one for you (“put the bill split in a note”).
- The API: the Notes routes.
- AI assistants: the note MCP tools. See MCP tools.
source that says who wrote it first:
The
source stays the same when the note is changed later.
Notes and your agents
When you ask an agent in the app for something, it first looks for the few notes that clearly bear on the request, by their words, and reads them as your own data, never as instructions. So a note such as “Lamp shopping rules: only the Halo lamp, under $40” shapes what the agent does next. An agent in the app deletes a note only after you say yes.Changing a note
Only what you send changes. The body changes one of three ways:
To mark someone as paid in a bill split, send
find: "| Tobi | 12,000 | owes |" and replace_with: "| Tobi | 12,000 | paid |". See Update a note.
Search
q finds the notes that contain any of its words in the title, body, tags, or topic. A word in the title counts most, then a tag or the topic, then the body. Matches come best first. topic, tag, and pinned keep only the notes that have them. See List notes.
Limits
Deleting a note is for good. It cannot be brought back.
An API key or an AI assistant needs
notes:read to list and read notes, and notes:write to write, change, or delete them. For an assistant, both are opt-in. See Authentication and scopes.