📝 Apple Notes MCP Server

MCP server for apple notes

Catalog onlyCatalog onlySTDIO

Overview

Apple Notes MCP Server is a Model Context Protocol server that allows users to interact with Apple Notes using natural language, enabling the creation, searching, and retrieval of notes effortlessly with AI assistance.

To use the server, clone the repository, install dependencies, build the project, and start the server. Configure your AI assistant (Claude) to connect with the server for note operations.

Create Notes: Quickly create new notes with titles, content, and tags. - Search Notes: Utilize powerful search capabilities to find notes. - Retrieve Content: Access the full content of any note by its title. - iCloud Integration: Directly works with your iCloud Notes account.

Quick note-taking during meetings or brainstorming sessions.
Searching for specific notes when needed.
Retrieving full content of notes for review.

Add to your AI client

Use these steps to connect 📝 Apple Notes MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-notes-siddhant-k-code": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "mcp-apple-notes-siddhant-k-code": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-apple-notes-siddhant-k-code": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "mcp-apple-notes-siddhant-k-code": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apple-notes-siddhant-k-code": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-apple-notes-siddhant-k-code": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-apple-notes-siddhant-k-code"
      ]
    }
  }
}

FAQ

Can I use this server on Windows?

No, it requires macOS with the Apple Notes app configured.

Is there a cost to use the Apple Notes MCP Server?

No, it is free to use.

What are the prerequisites for installation?

You need macOS, Node.js (version 20.0.0 or higher), and Yarn package manager.

Developer tools

📝 Apple Notes MCP Server — MCP Registry