Apple Notes MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| APPLE_NOTES_MCP_BACKUP_DIR | No | Directory for pre-mutation snapshots. Defaults to ~/.local/share/apple-notes-mcp/backups/. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list-notesB | Count the notes currently in the local index. |
| index-notesA | Index all Apple Notes for semantic search. Tell the user this can take from a few seconds to a few minutes depending on how many notes they have. |
| get-noteA | Get a note's full content and details by exact title. Optional |
| search-notesA | Search notes by meaning and by text (hybrid vector + full-text search). |
| create-noteB | Create a new Apple Note. Content must be HTML without newlines. |
| update-noteA | Replace the body of an existing Apple Note matched by exact title. Content must be HTML without newlines. The current body is snapshotted to disk before being overwritten. Fails (and leaves the note untouched) if zero or multiple notes share the title within the resolved scope (the whole Notes app if |
| append-noteA | Append HTML to the body of an existing Apple Note matched by exact title. Content must be HTML without newlines. The current body is snapshotted to disk before being modified. Fails (and leaves the note untouched) if zero or multiple notes share the title within the resolved scope (the whole Notes app if |
| backup-noteA | Snapshot the current HTML body of a note (matched by exact title) to disk and return the file path. Useful before risky multi-step edits. Fails if zero or multiple notes share the title within the resolved scope. Pass |
| list-foldersA | Return the names of all Apple Notes folders. |
| list-folder-notesB | List the titles of all notes inside a named Apple Notes folder. |
| create-note-in-folderA | Create a new Apple Note inside a specific folder. Content must be HTML without newlines. Fails if the folder does not exist — use list-folders to check first. |
| move-noteA | Move an existing Apple Note (matched by exact title) into the named destination |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools have clear, distinct purposes (get vs search, update vs append). The only potential confusion is between list-notes (which counts indexed notes) and list-folder-notes (which lists titles in a folder), and between create-note and create-note-in-folder, but the descriptions clarify these differences.
All tool names follow a consistent kebab-case verb-noun pattern (e.g., list-notes, get-note, update-note). Even the multi-word create-note-in-folder follows the same readable convention, making the set highly predictable.
With 12 tools, the server is well-scoped for Apple Notes management. It covers listing, indexing, searching, creating, updating, appending, backing up, and folder operations without feeling bloated or sparse.
The server provides strong read, create, and update capabilities, but lacks a delete-note tool, which is an obvious gap for a notes management server. Additionally, there is no way to list all notes across folders (only count via list-notes or list by folder), limiting full inventory management.