mcp-apple-notes — Claude Code MCP server for Apple Notes
Connect an MCP client to Apple Notes to manage notes and folders through an agent. Use it to search notes or update their contents from your coding assistant.
claude mcp add mcp-apple-notes -- uvx mcp-apple-notesWhat mcp-apple-notes does
The server exposes MCP tools for creating, reading, editing, deleting, moving, and searching notes. Folder tools cover creation, lookup, renaming, deletion, and moving. You can also inspect the folder and note hierarchy.
AppleScript handles communication with Apple Notes. Note content can use HTML, including headings, lists, tables, and links; nested folder paths support up to five levels. The server requires macOS, Python 3.10+, and the Apple Notes app. It needs permission to access Notes and run AppleScript, so check those macOS permissions before connecting it.
What it helps with
- create a note with HTML content
- find notes by keyword
- move a note to another folder
- rename or relocate a folder
- inspect the note and folder hierarchy
Example prompts for the agent
- Create an Apple Notes entry with a heading and a shopping list.
- Find notes containing “project” and show their folders.
- Move the note with ID
...into the “Archive” folder.
How to install mcp-apple-notes
Platform CLI
claude mcp add mcp-apple-notes -- uvx mcp-apple-notesuvx runs the command named after the package; if the README names another one, use uvx --from mcp-apple-notes <command>
Platform CLI
codex mcp add mcp-apple-notes -- uvx mcp-apple-notesuvx runs the command named after the package; if the README names another one, use uvx --from mcp-apple-notes <command>
Config file
{
"mcpServers": {
"mcp-apple-notes": {
"command": "uvx",
"args": [
"mcp-apple-notes"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-apple-notes <command>
Config file
{
"servers": {
"mcp-apple-notes": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-apple-notes"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from mcp-apple-notes <command>
Platform CLI
gemini mcp add mcp-apple-notes uvx mcp-apple-notesuvx runs the command named after the package; if the README names another one, use uvx --from mcp-apple-notes <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-apple-notes
How do I install mcp-apple-notes in Claude Code?
Run claude mcp add mcp-apple-notes -- uvx mcp-apple-notes. The server requires macOS, Python 3.10+, and Apple Notes; grant Claude Code permission to access Notes and run AppleScript.
What does mcp-apple-notes do?
It connects Apple Notes to an MCP client. An agent can manage notes and folders, search notes, and inspect their hierarchy.
What content can I put in an Apple Notes entry?
The server accepts HTML content, including headings, lists, tables, and links. Unicode text and emoji are supported too.
