{"id":22277360,"url":"https://github.com/sirmews/apple-notes-mcp","last_synced_at":"2025-07-28T17:31:57.921Z","repository":{"id":265694311,"uuid":"896406229","full_name":"sirmews/apple-notes-mcp","owner":"sirmews","description":"Read your Apple Notes with Claude Model Context Protocol","archived":false,"fork":false,"pushed_at":"2024-11-30T14:41:59.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-11-30T15:28:46.537Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sirmews.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-30T09:23:47.000Z","updated_at":"2024-11-30T14:42:03.000Z","dependencies_parsed_at":"2024-11-30T15:39:35.379Z","dependency_job_id":null,"html_url":"https://github.com/sirmews/apple-notes-mcp","commit_stats":null,"previous_names":["sirmews/apple-notes-mcp"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirmews%2Fapple-notes-mcp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirmews%2Fapple-notes-mcp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirmews%2Fapple-notes-mcp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sirmews%2Fapple-notes-mcp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sirmews","download_url":"https://codeload.github.com/sirmews/apple-notes-mcp/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":227941998,"owners_count":17844681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-12-03T14:54:21.363Z","updated_at":"2025-07-28T17:31:57.909Z","avatar_url":"https://github.com/sirmews.png","language":"Python","funding_links":[],"categories":["Data Access \u0026 Integration MCP Servers","📝 \u003ca name=\"note-taking\"\u003e\u003c/a\u003eNote Taking","Table of Contents","MCP 服务器精选列表","Legend","📦 Other","Other Tools and Integrations","サーバー実装","Note-Taking and Knowledge Bases","MCP Servers","File Systems","Productivity"],"sub_categories":["Other Tools and Integrations","🛠️ 效率工具与集成 (Office, Project Management, Notes, etc.)","🛠️ \u003ca name=\"other-tools-and-integrations\"\u003e\u003c/a\u003eOther Tools and Integrations","🛠️ \u003ca name=\"other-tools-and-integrations\"\u003e\u003c/a\u003eその他のツールと統合","🛠️ Other Tools and Integrations","How to Submit","Note Taking \u0026 Knowledge"],"readme":"# Apple Notes Model Context Protocol Server for Claude Desktop.\n\nRead your local Apple Notes database and provide it to Claude Desktop.\n\nNow Claude can search your most forgotten notes and know even more about you.\n\nNoting could go wrong.\n\n## Components\n\n### Resources\n\nThe server implements the ability to read and write to your Apple Notes.\n\n### Tools\n\nThe server provides multiple prompts:\n- `get-all-notes`: Get all notes.\n- `read-note`: Get full content of a specific note.\n- `search-notes`: Search through notes.\n\n### Missing Features:\n\n- No handling of encrypted notes (ZISPASSWORDPROTECTED)\n- No support for pinned notes filtering\n- No handling of cloud sync status\n- Missing attachment content retrieval\n- No support for checklist status (ZHASCHECKLIST)\n- No ability to create or edit notes\n\n## Quickstart\n\n### Install the server\n\nRecommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) to install the server locally for Claude.\n\n```\nuvx apple-notes-mcp\n```\nOR\n```\nuv pip install apple-notes-mcp\n```\n\nAdd your config as described below.\n\n#### Claude Desktop\n\nOn MacOS: `~/Library/Application\\ Support/Claude/claude_desktop_config.json`\nOn Windows: `%APPDATA%/Claude/claude_desktop_config.json`\n\nNote: You might need to use the direct path to `uv`. Use `which uv` to find the path.\n\n\n__Development/Unpublished Servers Configuration__\n  \n```json\n\"mcpServers\": {\n  \"apple-notes-mcp\": {\n    \"command\": \"uv\",\n    \"args\": [\n      \"--directory\",\n      \"{project_dir}\",\n      \"run\",\n      \"apple-notes-mcp\"\n    ]\n  }\n}\n```\n\n\n__Published Servers Configuration__\n  \n```json\n\"mcpServers\": {\n  \"apple-notes-mcp\": {\n    \"command\": \"uvx\",\n    \"args\": [\n      \"apple-notes-mcp\"\n    ]\n  }\n}\n```\n\n\n## Mac OS Disk Permissions\n\nYou'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.\n\nI 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.\n\n## Development\n\n### Building and Publishing\n\nTo prepare the package for distribution:\n\n1. Sync dependencies and update lockfile:\n```bash\nuv sync\n```\n\n2. Build package distributions:\n```bash\nuv build\n```\n\nThis will create source and wheel distributions in the `dist/` directory.\n\n3. Publish to PyPI:\n```bash\nuv publish\n```\n\nNote: You'll need to set PyPI credentials via environment variables or command flags:\n- Token: `--token` or `UV_PUBLISH_TOKEN`\n- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`\n\n### Debugging\n\nSince MCP servers run over stdio, debugging can be challenging. For the best debugging\nexperience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).\n\n\nYou can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:\n\n```bash\nnpx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp\n```\n\n\nUpon launching, the Inspector will display a URL that you can access in your browser to begin debugging.\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.\n\n## Source Code\n\nThe source code is available on [GitHub](https://github.com/sirmews/apple-notes-mcp).\n\n## Contributing\n\nSend your ideas and feedback to me on [Bluesky](https://bsky.app/profile/perfectlycromulent.bsky.social) or by opening an issue.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirmews%2Fapple-notes-mcp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsirmews%2Fapple-notes-mcp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsirmews%2Fapple-notes-mcp/lists"}