icloud-notes-connector

A Model Context Protocol (MCP) server that connects Claude Desktop to iCloud Notes on macOS. It allows Claude to search, read, list, create, update, move and delete notes directly from your iCloud Notes library.

Requirements

• macOS

• Claude Desktop

• Node.js v18 or later

• iCloud Notes enabled on your Mac

Related MCP server: Notes MCP Server

Installation

1. Clone this repository:

git clone https://github.com/tdavis10002/icloud-notes-connector.git
cd icloud-notes-connector

2. Install dependencies:

npm install

3. Add the server to your Claude Desktop configuration file at:

~/Library/Application Support/Claude/claude_desktop_config.json

Add the following entry under mcpServers:

{
  "mcpServers": {
    "icloud-notes-connector": {
      "command": "node",
      "args": ["/path/to/icloud-notes-connector/index.js"]
    }
  }
}

Replace /path/to/icloud-notes-connector with the actual path where you cloned the repository.

4. Restart Claude Desktop.

Permissions

The first time Claude uses the connector, macOS will display an Automation permission prompt asking to allow the app to control Notes. Click OK to approve it.

If the prompt does not appear, go to System Settings > Privacy & Security > Automation and enable Notes access for the app running the connector (typically Terminal or Node).

Tools

Notes

• All tools default to the iCloud account. Pass the account parameter to target a different account.

• search_notes returns results in the Notes app default sort order - most recently modified first.

• search_notes checks every note in the account and may be slow on very large libraries.

• delete_note cannot be undone.

• If multiple notes share the same title, tools that target a single note will act on the first match. Use list_notes to retrieve the note ID to disambiguate if needed.

License

MIT