Apple Notes
Search, read and write Apple Notes on a Mac, with edits off by default
- Pricing
- Free trial
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.40.0
- Listing updated
- 3 days ago
About Apple Notes
Apple Notes is an MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Notes can be limited to specific accounts: APPLE_NOTES_ACCOUNTS restricts every read and write by account name, and attachments can only be saved into one directory (default ~/Downloads). Bodies are truncated at 262,144 bytes by default to protect the model's context window.
Eight read tools cover diagnostics, accounts, folders, notes, search, getting a note, listing and saving attachments. The five write tools, create_note, update_note, move_note, delete_notes and add_attachment, are registered only when APPLE_NOTES_ALLOW_WRITES=1; with it off they are invisible to the model. add_attachment is the only way to put an image into a note.
Two permissions matter: Automation for Notes is required for everything, while Full Disk Access enables search at scale and save_attachment; without it the server runs on the slower Apple Events path. MIT licensed, unofficial, macOS 26 or later.
Install
Run in a terminal
claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notesAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-notes": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-notes": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-apple-notes": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-apple-notes": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-apple-notes": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-notes"
]
}
}
}Configuration
APPLE_NOTES_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.APPLE_NOTES_ACCOUNTSRestrict every read and write to these Notes accounts, by name.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- diagnostics
- No description
- list_accounts
- No description
- list_folders
- No description
- list_notes
- No description
- search_notes
- No description
- get_note
- No description
- list_attachments
- No description
- save_attachment
- No description
- create_note
- No description
- update_note
- No description
- move_note
- No description
- delete_notes
- No description
- add_attachment
- No description
What it does
- Account allowlist
- Restrict reads and writes to named Notes accounts.
- Read tools
- Browse folders, search and fetch notes.
- Gated writes
- Create, update, move and delete exist only when enabled.
- Attachment handling
- List and save attachments; add images with add_attachment.
- Body size cap
- Truncates note bodies to protect context.
Good for
- Search personal notes during an agent task
- Turn meeting notes into a summary
- Create a note from an agent after enabling writes
- Save an attachment from a note to Downloads
Pricing
Free trial
Servers MIT; Cupertino app has a 30-minute trial and 30-day refund; price not published
Prices change. Check cupertino.mgcrea.io before you buy.
Apple Notes FAQ
What permissions are needed?
Automation for Notes for everything; Full Disk Access for search at scale and save_attachment.
Can an agent delete notes by default?
No. Write tools are invisible unless APPLE_NOTES_ALLOW_WRITES=1.
How do I limit which notes it sees?
Set APPLE_NOTES_ACCOUNTS to a comma-separated list.
Is Apple Notes free?
Apple Notes is a paid product with a free trial.
How do I add Apple Notes to Claude Code?
Run this command in your terminal: claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes
What are the best alternatives to Apple Notes?
The closest alternatives to Apple Notes are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.
Alternatives to Apple Notes

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools