Apple Notes
MCP server to search, create and organise notes and folders in macOS Notes
- Pricing
- Open source
- Platforms
- macOS, CLI
- Runs
- Locally
- Version
- 1.1.7
- Listing updated
- today
Similar MCP servers
About Apple Notes
Apple Notes is an open-source MCP server for knowledge and memory. It runs locally on your machine and is started by your AI client.
Notes stays the system of record here: the server drives the native Notes app through AppleScript so an agent can read, create, edit, move and delete notes without a separate store. Search results include the note plaintext, so queries match body text as well as titles and tags.
It copes with multiple accounts by listing accounts and folders first, and an allowed-accounts setting can restrict which ones it touches. Every AppleScript call has a timeout, 60 seconds by default, so a stalled Notes app cannot hang a request. If a create times out it returns NOTE_CREATE_STATUS_UNKNOWN and leaves matching notes alone, so you inspect the folder before retrying.
Safety modes are safe_readonly, safe_manage and full_access, and unlike its siblings it defaults to full_access. The README suggests keeping time-sensitive items in Reminders or Calendar instead.
Install
Run in a terminal
claude mcp add apple-mcp-notes -- uvx apple-mcp-notesAdd to claude_desktop_config.json
{
"mcpServers": {
"apple-mcp-notes": {
"command": "uvx",
"args": [
"apple-mcp-notes"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"apple-mcp-notes": {
"command": "uvx",
"args": [
"apple-mcp-notes"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"apple-mcp-notes": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-mcp-notes"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"apple-mcp-notes": {
"command": "uvx",
"args": [
"apple-mcp-notes"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"apple-mcp-notes": {
"command": "uvx",
"args": [
"apple-mcp-notes"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
APPLE_NOTES_MCP_SAFETY_MODESafety mode for Notes operations: safe_readonly, safe_manage, or full_access.APPLE_NOTES_MCP_ALLOWED_ACCOUNTSComma-separated allow-list of Notes account names. Empty allows all accounts.APPLE_NOTES_MCP_ALLOWED_FOLDERSComma-separated allow-list of Notes folder names. Empty allows all folders.
Tools this server provides (5)
Taken from the project documentation; the running server may differ.
- search_tools
- Lists available tools for context-constrained clients.
- get_tool_info
- Returns details for one tool.
- notes_health
- Checks Notes server health.
- notes_permission_guide
- Explains how to grant Notes automation access.
- notes_recheck_permissions
- Rechecks permissions after a macOS change.
What it does
- Note CRUD
- List, search, create, edit, move and delete notes.
- Folder management
- Create, rename and delete folders.
- Attachment listing
- Lists attachments on a note.
- Body-text search
- Search matches note plaintext, titles and tags.
- Account allowlist
- Limits which Notes accounts the server can use.
- Script timeout
- Bounded AppleScript calls, 60 seconds by default.
Good for
- Save reference material from a chat into a folder
- Search old notes by body text
- Reorganise notes across folders
- List recent notes for context
- Rename or tidy folders
Pricing
Open source
Apple Notes FAQ
What permission does it need?
Automation access to Notes on macOS.
What is the default safety mode?
full_access, with safe_readonly and safe_manage available.
What happens if a create times out?
It returns NOTE_CREATE_STATUS_UNKNOWN and you should inspect the folder before retrying.
How do I install it?
Run uvx apple-mcp-notes.
Can locked notes be read?
Locked or unavailable note fields can come back empty.
Is Apple Notes free?
Yes. Apple Notes is open source, so you can use and self-host it for free.
How do I add Apple Notes to Claude Code?
Run this command in your terminal: claude mcp add apple-mcp-notes -- uvx apple-mcp-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 Concord MCP.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.



