Notes
The notes endpoints of the FocusCrew API.
A * marks a required field. Path fields go in the address, query fields after a ?, body fields in JSON.
/api/v1/notesYour notes
Your folders and notes — titles and the first 200 characters, never a locked note’s words.
MCP tool: list_notes
/api/v1/notes/{id}One note, as Markdown
A note you can open, rendered to Markdown. Locked notes are not readable through the API.
| Field | In | Type | Meaning |
|---|---|---|---|
| id * | path | uuid | The id. |
MCP tool: read_note
/api/v1/notesWrite a note
A new note from Markdown — headings, lists, links, checklists. Up to 10,000 characters. Plan limits apply.
| Field | In | Type | Meaning |
|---|---|---|---|
| markdown * | body | string | The note’s body. |
| title | body | string | Taken from the first heading when omitted. |
| folderId | body | uuid | A folder of yours; the top level when omitted. |
{ "title": "Meeting notes", "markdown": "## Decisions\n- Ship on Friday\n- [ ] Tell the crew" }MCP tool: create_note