mcp-registry/apple-notes-mcp

    ==================
      
       /// MCP ///
      /// APP ///
        
    ==================
        
    [server:online]
    [protocol:ready]

apple-notes-mcp

by sirmews

Model Context Protocol (MCP) server that exposes your local Apple Notes database to Claude Desktop. Offers tools for listing, reading and searching notes.

113
12
Specialized
GitHubDocumentation

01

get-all-notes

Get all notes.

02

read-note

Get full content of a specific note.

03

search-notes

Search through notes.

Installation

1. Clone the repository:
git clone https://github.com/sirmews/apple-notes-mcp.git && cd apple-notes-mcp
2. Create and activate a virtual-environment (recommended):
python3 -m venv .venv source .venv/bin/activate # Windows: .venv\Scripts\activate
3. Install Python dependencies:
pip install -r requirements.txt
4. 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 provided
7. Open http://localhost:3333/health to verify the service is running.

Documentation

License: MIT License
Updated 7/30/2025