Apple Notes MCP Server

An MCP (Model Context Protocol) server that lets AI assistants like Claude read, create, search, update, and delete your Apple Notes all through natural conversation.

Built with JXA (JavaScript for Automation) to communicate with the Notes app directly.

 

Requirements

• macOS (Apple Notes is macOS-only)

• Node.js 18+

• An MCP-compatible client (e.g., Claude Code, Claude Desktop)

 

Related MCP server: Apple Notes MCP Server

Setup

 

1. Clone and build

git clone https://github.com/RodriguesJohn/applenotesmcp.git
cd applenotesmcp
npm install
npm run build

 

2. Configure your MCP client

 

Claude Code

Add to your ~/.mcp.json:

{
  "mcpServers": {
    "apple-notes": {
      "command": "node",
      "args": ["/path/to/applenotesmcp/dist/index.js"]
    }
  }
}

Then restart Claude Code.

 

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "apple-notes": {
      "command": "node",
      "args": ["/path/to/applenotesmcp/dist/index.js"]
    }
  }
}

Then restart Claude Desktop.

Note: Replace /path/to/applenotesmcp with the actual path where you cloned the repo.

 

3. Grant permissions

The first time a tool runs, macOS will prompt you to allow your terminal (or Claude Desktop) to control the Notes app. Click OK to grant access.

 

Available Tools

 

Usage Examples

Once connected, just ask Claude naturally:

• "List all my notes folders"

• "Show me my recent notes"

• "Find notes about project ideas"

• "Create a note called 'Meeting Notes' with today's action items"

• "Update my grocery list note"

 

License

ISC

Learn building with AI from here - https://www.theaidesignacademy.com/