Apple Notes MCP Server
Enables Claude Desktop to access and interact with local Apple Notes.
Key Features
Use Cases
README
Apple Notes Model Context Protocol Server for Claude Desktop.
Read your local Apple Notes database and provide it to Claude Desktop.
Now Claude can search your most forgotten notes and know even more about you.
Noting could go wrong.
Components
Resources
The server implements the ability to read and write to your Apple Notes.
Tools
The server provides multiple prompts:
get-all-notes: Get all notes.read-note: Get full content of a specific note.search-notes: Search through notes.
Missing Features:
- No handling of encrypted notes (ZISPASSWORDPROTECTED)
- No support for pinned notes filtering
- No handling of cloud sync status
- Missing attachment content retrieval
- No support for checklist status (ZHASCHECKLIST)
- No ability to create or edit notes
Quickstart
Install the server
Recommend using uv to install the server locally for Claude.
uvx apple-notes-mcp
OR
uv pip install apple-notes-mcp
Add your config as described below.
Claude Desktop
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Note: You might need to use the direct path to uv. Use which uv to find the path.
Development/Unpublished Servers Configuration
"mcpServers": {
"apple-notes-mcp": {
"command": "uv",
"args": [
"--directory",
"{project_dir}",
"run",
"apple-notes-mcp"
]
}
}
Published Servers Configuration
"mcpServers": {
"apple-notes-mcp": {
"command": "uvx",
"args": [
"apple-notes-mcp"
]
}
}
Mac OS Disk Permissions
You'll need to grant Full Disk Access to the server. This is because the Apple Notes sqlite database is nested deep in the MacOS file system.
I may look at an AppleScript solution in the future if this annoys me further or if I want to start adding/appending to Apple Notes.
Development
Building and Publishing
To prepare the package for distribution:
- Sync dependencies and update lockfile:
uv sync
- Build package distributions:
uv build
This will create source and wheel distributions in the dist/ directory.
- Publish to PyPI:
uv publish
Note: You'll need to set PyPI credentials via environment variables or command flags:
- Token:
--tokenorUV_PUBLISH_TOKEN - Or username/password:
--username/UV_PUBLISH_USERNAMEand--password/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm with this command:
npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
License
This project is licensed under the MIT License. See the LICENSE file for details.
Source Code
The source code is available on GitHub.
Contributing
Send your ideas and feedback to me on Bluesky or by opening an issue.
Star History
Repository Owner
User
Repository Details
Programming Languages
Tags
Join Our Newsletter
Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.
Related MCPs
Discover similar Model Context Protocol servers
MCP Manager for Claude Desktop
A desktop app to manage Model Context Protocol (MCP) servers for Claude Desktop on MacOS.
MCP Manager for Claude Desktop provides a user-friendly interface to manage Model Context Protocol (MCP) servers, enabling Claude to access private data, APIs, and local or remote services securely from a MacOS desktop. It facilitates rapid configuration and integration with a wide variety of MCP servers, including productivity tools, databases, and web APIs. The app runs locally to ensure data privacy and streamlines connecting Claude to new sources through simple environment and server settings management.
- ⭐ 270
- MCP
- zueai/mcp-manager
Notion MCP Server
Enable LLMs to interact with Notion using the Model Context Protocol.
Notion MCP Server allows large language models to interface with Notion workspaces through a Model Context Protocol server, supporting both data retrieval and editing capabilities. It includes experimental Markdown conversion to optimize token usage for more efficient communication with LLMs. The server can be configured with environment variables and controlled for specific tool access. Integration with applications like Claude Desktop is supported for seamless automation.
- ⭐ 834
- MCP
- suekou/mcp-notion-server
HackMD MCP Server
MCP server connecting LLM clients to the HackMD collaborative note platform.
HackMD MCP Server implements the Model Context Protocol (MCP) to provide a standardized interface between large language model (LLM) clients and the HackMD collaborative note service. Through HTTP and STDIO transports, it enables creation, retrieval, update, and deletion of notes, along with management of teams, user profiles, and history data. It supports deployment in both local and cloud environments, with secure API token-based authentication and configuration via environment variables or HTTP headers.
- ⭐ 43
- MCP
- yuna0x0/hackmd-mcp
Perplexity MCP Server
MCP Server integration for accessing the Perplexity API with context-aware chat completion.
Perplexity MCP Server provides a Model Context Protocol (MCP) compliant server that interfaces with the Perplexity API, enabling chat completion with citations. Designed for seamless integration with clients such as Claude Desktop, it allows users to send queries and receive context-rich responses from Perplexity. Environment configuration for API key management is supported, and limitations with long-running requests are noted. Future updates are planned to enhance support for client progress reporting.
- ⭐ 85
- MCP
- tanigami/mcp-server-perplexity
anki-mcp
MCP server for seamless integration with Anki via AnkiConnect.
An MCP server that bridges Anki flashcards with the Model Context Protocol, exposing AnkiConnect functionalities as standardized MCP tools. It organizes Anki actions into intuitive services covering decks, notes, cards, and models for easy access and automation. Designed for integration with AI assistants and other MCP-compatible clients, it enables operations like creating, modifying, and organizing flashcards through a unified protocol.
- ⭐ 6
- MCP
- ujisati/anki-mcp
MCP Claude Spotify
Connect Claude Desktop to Spotify using the Model Context Protocol.
MCP Claude Spotify enables seamless integration between Claude Desktop and Spotify using the Model Context Protocol (MCP). It allows users to authenticate with Spotify, control playback, manage playlists, search for music, and access personalized recommendations directly from Claude Desktop. The solution supports both manual setup and auto-start with Claude Desktop, making it easy to interact with the Spotify API in a standardized way. Spotify credentials are required for setup and operation.
- ⭐ 20
- MCP
- imprvhub/mcp-claude-spotify
Didn't find tool you were looking for?