Home / MCP / Apple Notes MCP Server

Apple Notes MCP Server

Reads Apple Notes locally and exposes prompts to list, read, and search notes for Claude Desktop.

other

120stars

View on GitHub

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
    "mcpServers": {
        "apple_notes_mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "{project_dir}",
                "run",
                "apple-notes-mcp"
            ]
        }
    }
}

This MCP server lets Claude Desktop read your local Apple Notes database to enable fast search and retrieval of your notes. It runs locally, communicates over stdio, and exposes simple prompts to list, read, and search notes so Claude can assist you more effectively.

How to use

You run the Apple Notes MCP server locally and connect Claude Desktop to it. Once connected, you can use prompts to get all notes, read a specific note by its content, or search through your notes for keywords. The server is designed to read from the Apple Notes database and provide content to Claude for quick access, without editing or creating notes.

How to install

Prerequisites: install a runtime that can host MCP servers and the MCP runner. You will need Node tooling for the runner and Python for building or packaging if you plan to publish, but the typical local run uses the MCP runner commands shown below.

Step 1: Install the server locally using one of the provided runners.

uvx apple-notes-mcp
```
OR
```
uv pip install apple-notes-mcp

Step 2: Add the MCP server configuration to Claude Desktop so it can locate and start your server. Place one of the configurations below in your Claude desktop MCP setup file, depending on whether you’re using a development/unpublished or a published setup.

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uv",
    "args": [
      "--directory",
      "{project_dir}",
      "run",
      "apple-notes-mcp"
    ]
  }
}

Or, for the published configuration, use the runtime that Claude expects for a production setup.

"mcpServers": {
  "apple-notes-mcp": {
    "command": "uvx",
    "args": [
      "apple-notes-mcp"
    ]
  }
}

Step 3: Grant necessary disk access on macOS. You will be prompted to allow full disk access so the server can read the Apple Notes SQLite database, which is stored in a protected location on the system.

Configuration notes

The server exposes simple prompts you can call from Claude to interact with your notes: get-all-notes, read-note, and search-notes. These prompts pull data from your local Apple Notes database and return content to Claude for quick reference.

Environment and building notes: If you plan to develop or publish the server, you may use the standard MCP development flow to sync dependencies, build distributions, and publish. The typical commands are to synchronize dependencies, build, and publish.

Debugging and inspection

For debugging, you can use the MCP Inspector to inspect the runtime interaction. Launch the inspector with the following command, substituting the project directory path where appropriate.

npx @modelcontextprotocol/inspector uv --directory {project_dir} run apple-notes-mcp

The Inspector will show a URL you can open in your browser to begin debugging and tracing the flow between Claude Desktop and your local MCP server.

Available tools

get-all-notes

Fetches all notes from the Apple Notes database and returns a list of note summaries.

read-note

Retrieves the full content of a specific note identified by its ID or title.

search-notes

Searches notes for keywords and returns matching results.