Apple Notes MCP Server

Knowledge & MemoryPython

Access and search your Apple Notes from Claude

Available Tools

get-all-notes

Retrieves all notes from your Apple Notes database

read-note

Gets the full content of a specific note

search-notes

Searches through your notes using keywords

Apple Notes MCP allows Claude to read and search through your local Apple Notes database. This integration gives Claude access to your personal notes, enabling it to reference important information you've saved without requiring you to manually copy and paste content. The server provides comprehensive search capabilities and can retrieve both full and partial note content.

Overview

Apple Notes MCP provides Claude with access to your Apple Notes database, allowing it to search and read your notes directly. This integration helps Claude reference your personal information without requiring manual copying and pasting.

Installation

Prerequisites

macOS (required for Apple Notes access)
uv package manager

Installation Steps

Install the Apple Notes MCP server using uv:

uvx apple-notes-mcp

Alternatively, you can use:

uv pip install apple-notes-mcp

Configure Claude Desktop to use the server by editing the configuration file:

On macOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

Add the following to your configuration file:

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

If you're using a development version or unpublished server, use this configuration instead:

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

macOS Disk Permissions

Since the Apple Notes database is stored deep in the macOS file system, you'll need to grant Full Disk Access to the server. Go to System Preferences > Security & Privacy > Privacy > Full Disk Access and add the necessary permissions.

Usage

Once installed, you can ask Claude to:

Retrieve all your notes
Search for specific notes by keyword
Read the full content of a particular note

For example, you can say:

"Show me all my Apple Notes"
"Search my notes for information about [topic]"
"Find the note I wrote about [subject]"

Limitations

The current implementation has several limitations:

Cannot access encrypted notes
No support for filtering pinned notes
Cannot retrieve attachment content
No support for checklist status
Cannot create or edit notes
No handling of cloud sync status

Troubleshooting

If you encounter issues with the MCP server, you can use the MCP Inspector for debugging:

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

This will provide a URL you can access in your browser to debug the connection.