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)

 

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

Tool	Description
list_folders	List all folders across all accounts
list_notes	List notes, optionally filtered by folder (default limit: 50)
get_note	Get full content of a note by title
get_note_by_id	Get full content of a note by its unique ID
search_notes	Search notes by keyword in title or body (max 25 results)
create_note	Create a new note with a title and body (HTML supported)
update_note	Update the body content of an existing note
delete_note	Delete a note by title (moves to Recently Deleted)

 

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/