apple-notes-mcp is a Model Context Protocol (MCP) server developed by sirmews, designed specifically for Claude Desktop. Its core purpose is to read the local Apple Notes database and provide note content to Claude Desktop, enabling Claude to search those easily forgotten notes and thereby better understand the user's information. The project description states: "Now Claude can search your most forgotten notes and get to know you better."
In terms of main capabilities, the server implements the ability to read and write Apple Notes, and provides multiple prompts: get-all-notes is used to get all notes; read-note is used to get the full content of a specific note; search-notes is used to search notes.
In terms of usage, it is recommended to install the server locally using uv, and then add the configuration to Claude's configuration file according to the instructions. Configuration file locations: on macOS, ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows, %APPDATA%/Claude/claude_desktop_config.json. It may be necessary to use the direct path to uv, which can be found with the which uv command. The project also provides instructions for development/unpublished server configuration and published server configuration.
Regarding macOS disk permissions, this server needs to be granted Full Disk Access, because the Apple Notes sqlite database is nested deep within the macOS file system.
Regarding building and publishing, the project explains the steps to prepare a distribution package: sync dependencies and update the lock file, build the package distribution (which will generate source and wheel distributions in the dist/ directory), and publish to PyPI (PyPI credentials need to be set via environment variables or command flags: for tokens use --token or UV_PUBLISH_TOKEN; for username/password use --username / UV_PUBLISH_USERNAME and --password / UV_PUBLISH_PASSWORD).
Because the MCP server runs over stdio , debugging can be challenging. For the best debugging experience, it is strongly recommended to use MCP Inspector, which can be started via an npm command. After startup, Inspector will display a URL that can be accessed in a browser to begin debugging.
The project uses the MIT license, and the source code is available on GitHub. The author welcomes ideas and feedback via Bluesky, or issue submissions.
Known missing features include: it does not handle encrypted notes (ZISPASSWORDPROTECTED); it does not support pinned note filtering; it does not handle cloud sync status; it lacks attachment content retrieval; it does not support checklist status (ZHASCHECKLIST); it cannot create or edit notes.
The above is the information explicitly provided in the project description. Details such as other features, fees, pricing, platforms, or usage effects have not been provided.
