Design Engineer Logo
Visit Repo
Open Graph preview

Apple Notes MCP

Read your Apple Notes with Claude via Model Context Protocol

Site favicon
💡 Knowledge Base

Overview

Apple Notes MCP

Description:
A server that enables Claude to read and search through your local Apple Notes database.

Category: Note Management & Integration

Overview:
This server provides seamless access to Apple Notes content through Claude Desktop, allowing interaction with your notes database. Key functionalities include retrieving all notes, reading specific notes, and performing searches across your notes collection.

Important considerations:

  • Requires Full Disk Access permissions on MacOS
  • Doesn't support encrypted notes
  • Cannot handle cloud sync status or attachments
  • No support for checklist status or note editing
  • Pinned notes filtering not available

Installation:

uv pip install apple-notes-mcp

Configuration:
Add to Claude Desktop config file:

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

Development Setup:

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

Tools Available:

  • get-all-notes: Retrieves complete notes collection
  • read-note: Fetches specific note content
  • search-notes: Performs note search operations

Location of Config Files:

  • MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%/Claude/claude_desktop_config.json

Licensed under MIT License.