apple-notes-mcp
Author: sirmews
Description: Model Context Protocol (MCP) server that exposes your local Apple Notes database to Claude Desktop. Offers tools for listing, reading and searching notes.
Stars: 113
Forks: 12
License: MIT License
Category: Specialized
Overview
Installation
1. Clone the repository:
git clone https://github.com/sirmews/apple-notes-mcp.git && cd apple-notes-mcp2. Create and activate a virtual-environment (recommended):
python3 -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate3. Install Python dependencies:
pip install -r requirements.txt4. Provide Apple Notes data:
• Export your notes from macOS Notes (File ▸ Export All Notes…)
• Place the resulting .notesarchive or .html export inside ./data or configure the NOTES_PATH environment variable.
5. Configuration (environment variables or .env file):
NOTES_PATH=/absolute/path/to/your/export
MCP_PORT=3333 # Port the server will bind to
CLAUDE_API_KEY=sk-...
(Any other Claude-specific settings such as WORKSPACE_ID)6. Run the server:
python -m apple_notes_mcp.server # or `make run` if a Makefile is provided7. Open http://localhost:3333/health to verify the service is running.
01
get-all-notes
Get all notes.
02
read-note
Get full content of a specific note.
03
search-notes
Search through notes.
License: MIT License
Updated 7/30/2025