Skip to content
Back to search

apple-notes-mcp

Read your Apple Notes with Claude Model Context Protocol

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/sirmews--apple-notes-mcp/badge.svg)](/listings/sirmews--apple-notes-mcp)

HTML

<a href="/listings/sirmews--apple-notes-mcp"><img src="/api/listings/sirmews--apple-notes-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

Install the server

Recommend using [uv](https://docs.astral.sh/uv/getting-started/installation/) 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"
    ]
  }
}

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 144 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

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

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.