Apple Notes MCP

1# Apple Notes Model Context Protocol Server for Claude Desktop.
2 
3Read your local Apple Notes database and provide it to Claude Desktop.
4 
5Now Claude can search your most forgotten notes and know even more about you.
6 
7Noting could go wrong.
8 
9## Components
10 
11### Resources
12 
13The server implements the ability to read and write to your Apple Notes.
14 
15### Tools
16 
17The server provides multiple prompts:
18- `get-all-notes`: Get all notes.
19- `read-note`: Get full content of a specific note.
20- `search-notes`: Search through notes.
21 
22### Missing Features:
23 
24- No handling of encrypted notes (ZISPASSWORDPROTECTED)
25- No support for pinned notes filtering
26- No handling of cloud sync status
27- Missing attachment content retrieval
28- No support for checklist status (ZHASCHECKLIST)
29- No ability to create or edit notes
30 
31## Quickstart
32 
33### Install the server
34 
35Recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) to install the server locally for Claude.
36 
37```
38uvx apple-notes-mcp
39```
40OR
41```
42uv pip install apple-notes-mcp
43```
44 
45Add your config as described below.
46 
47#### Claude Desktop
48 
49On MacOS: `~/Library/Application\ Support/Claude/claude_desktop_config.json`
50On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
51 
52Note: You might need to use the direct path to `uv`. Use `which uv` to find the path.
53 
54 
55__Development/Unpublished Servers Configuration__
56  
57```json
58"mcpServers": {
59  "apple-notes-mcp": {
60    "command": "uv",
61    "args": [
62      "--directory",
63      "{project_dir}",
64      "run",
65      "apple-notes-mcp"
66    ]
67  }
68}
69```
70 
71 
72__Published Servers Configuration__
73  
74```json
75"mcpServers": {
76  "apple-notes-mcp": {
77    "command": "uvx",
78    "args": [
79      "apple-notes-mcp"
80    ]
81  }
82}
83```
84 
85 
86## Mac OS Disk Permissions
87 
88You'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.
89 
90I 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.
91 
92## Development
93 
94### Building and Publishing
95 
96To prepare the package for distribution:
97 
981. Sync dependencies and update lockfile:
99```bash
100uv sync
101```
102 
1032. Build package distributions:
104```bash
105uv build
106```
107 
108This will create source and wheel distributions in the `dist/` directory.
109 
1103. Publish to PyPI:
111```bash
112uv publish
113```
114 
115Note: You'll need to set PyPI credentials via environment variables or command flags:
116- Token: `--token` or `UV_PUBLISH_TOKEN`
117- Or username/password: `--username`/`UV_PUBLISH_USERNAME` and `--password`/`UV_PUBLISH_PASSWORD`
118 
119### Debugging
120 
121Since MCP servers run over stdio, debugging can be challenging. For the best debugging
122experience, we strongly recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector).
123 
124 
125You can launch the MCP Inspector via [`npm`](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm) with this command:
126 
127```bash
128npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp
129```
130 
131 
132Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
133 
134## License
135 
136This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.
137 
138## Source Code
139 
140The source code is available on [GitHub](https://github.com/sirmews/apple-notes-mcp).
141 
142## Contributing
143 
144Send your ideas and feedback to me on [Bluesky](https://bsky.app/profile/perfectlycromulent.bsky.social) or by opening an issue.
145