Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOTES_MCP_SAFE | No | Set to '1' to block writes and enable read-only exploration (safe mode). |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| notes.list_folders | List all Apple Notes folders. |
| folders.ensure | Ensure a folder path exists (e.g., 'mcp' or 'parent/child'). |
| folders.delete | Delete a folder by nested path (e.g., 'parent/child'). |
| notes.append_text | Append plain text to a note body. |
| notes.add_checklist | Append checklist items to a note. |
| notes.apply_format | Apply simple formatting to entire note body. |
| notes.move | Move a note to another folder by folderId or path. |
| folders.rename | Rename a folder at nested path. |
| folders.contents | List notes and subfolders for a folder path. |
| notes.search | Search notes by name (fast) or body (slower). |
| notes.add_link | Append a hyperlink to a note. |
| notes.toggle_checklist | Toggle or set a checklist item by index. |
| notes.remove_checklist | Remove a checklist item by index. |
| notes.apply_action_plan_template | Overwrite a note body with a professional action plan (headings, lists, timestamp). |
| notes.list | List notes optionally filtered by folder or query. |
| notes.get | Fetch a note by ID. |
| notes.create | Create a new note with optional folder, title and body. |
| notes.update | Update a note's title/body. Optionally append body. |
| notes.delete | Delete a note by ID (moves to Recently Deleted). |
| notes.index_build | Builds a local search index over all notes (runs in background). |
| notes.index_status | Check if a local search index exists and when it was updated. |
| notes.index_search | Fast search using the local index (run index_build first). |
| server.status | Get server status including safe mode flag. |
| server.set_safe_mode | Enable/disable safe (read-only) mode for write ops. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |