Apple Notes
MCP server for Apple Notes - create, search, update, and manage notes via Claude and other AI assistants
What is Apple Notes?
Apple Notes is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for apple notes - create, search, update, and manage notes via claude and other ai assistants
MCP server for Apple Notes - create, search, update, and manage notes via Claude and other AI assistants
This server falls under the Knowledge & Memory category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- MCP server for Apple Notes - create, search, update, and man
Use Cases
Maintainer
Works with
Installation
NPM
npx -y apple-notes-mcpManual Installation
npx -y apple-notes-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Apple Notes
Apple Notes MCP Server gives AI assistants read access to your local Apple Notes database on macOS, allowing you to search through notes, retrieve individual note content, and list all your notes through natural language without switching apps. It uses direct SQLite access to the Apple Notes backing store rather than AppleScript, so it is fast and does not require the Notes app to be open. This server is ideal for developers and knowledge workers who keep notes in Apple Notes and want their AI assistant to reference that information during conversations.
Prerequisites
- macOS (the server accesses the Apple Notes local SQLite database, which only exists on macOS)
- uv package manager installed (https://docs.astral.sh/uv/)
- Full Disk Access granted to the terminal or application running the server (required to read the Notes database)
- An MCP-compatible client such as Claude Desktop
Install uv if not already installed
The server is distributed as a Python package run via uvx. Install the uv package manager from Astral.
curl -LsSf https://astral.sh/uv/install.sh | shGrant Full Disk Access to your terminal
Open System Settings → Privacy & Security → Full Disk Access and add your terminal application (Terminal.app, iTerm2, or the Claude Desktop helper). Without this the server cannot read the Notes SQLite database.
Add the server to your MCP client config
Edit your Claude Desktop configuration file to include the apple-notes-mcp server entry.
Restart Claude Desktop
Quit and relaunch Claude Desktop so it picks up the new server configuration and starts the server process.
Test the connection
Ask Claude to search your notes or list all notes. A successful response means the server can read your Apple Notes database.
Apple Notes Examples
Client configuration
Add this block to ~/Library/Application Support/Claude/claude_desktop_config.json. The server runs via uvx with no additional environment variables required.
{
"mcpServers": {
"apple-notes-mcp": {
"command": "uvx",
"args": ["apple-notes-mcp"]
}
}
}Prompts to try
Once connected, Claude can search and read your Apple Notes content.
- "Search my Apple Notes for anything about 'project roadmap'"
- "Read the note titled 'Meeting notes from last Tuesday'"
- "List all my notes from the Work folder"
- "Find notes that mention the word 'budget' and summarize them"
- "What did I write about machine learning in my notes?"Troubleshooting Apple Notes
Server returns 'permission denied' or cannot find the Notes database
The Notes database is at ~/Library/Group Containers/group.com.apple.notes/. Grant Full Disk Access in System Settings → Privacy & Security → Full Disk Access to the application running the MCP server (Terminal, iTerm2, or Claude Desktop). Restart the application after granting access.
uvx command not found
Install uv with 'curl -LsSf https://astral.sh/uv/install.sh | sh' and restart your terminal. Alternatively, install via pip: 'pip install apple-notes-mcp' and change the command in config to 'apple-notes-mcp'.
Encrypted notes return empty content
The server does not support locked/encrypted notes — this is a known limitation. Unlock notes in the Notes app before querying, or avoid encrypting notes you want the AI to access.
Frequently Asked Questions about Apple Notes
What is Apple Notes?
Apple Notes is a Model Context Protocol (MCP) server that mcp server for apple notes - create, search, update, and manage notes via claude and other ai assistants It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Apple Notes?
Install via npm with the command: npx -y apple-notes-mcp. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Apple Notes?
Apple Notes works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Apple Notes free to use?
Yes, Apple Notes is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
Apple Notes Alternatives — Similar Knowledge & Memory Servers
Looking for alternatives to Apple Notes? Here are other popular knowledge & memory servers you can use with Claude, Cursor, and VS Code.
MemPalace
★ 52.6kA local AI memory system that stores all conversations verbatim and organizes them into navigable structures. It provides 19 MCP tools for AI assistants to search and retrieve past decisions, debugging sessions, and architecture debates automatically
Kratos
★ 25.7k🏛️ Memory System for AI Coding Tools - Never explain your codebase again. MCP server with perfect project isolation, 95.8% context accuracy, and the Four Pillars Framework.
Context Mode
★ 15.4kAn MCP server that preserves LLM context by intercepting large data outputs and returning only concise summaries or relevant sections. It enables efficient sandboxed code execution, file processing, and documentation indexing across multiple programm
Memu
★ 13.7kMemory for 24/7 proactive agents like OpenClaw.
MemOS
★ 9.3kMemOS (Memory Operating System) is a memory management operating system designed for AI applications. Its goal is: to enable your AI system to have long-term memory like a human, not only remembering what users have said but also actively invoking, u
Everos
★ 5.4kBuild, evaluate, and integrate long-term memory for self-evolving agents.
Browse More Knowledge & Memory MCP Servers
Explore all knowledge & memory servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Apple Notes in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Apple Notes?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.