📝 Apple Notes MCP Server

What is Apple Notes MCP Server?

Apple Notes MCP Server is a Model Context Protocol server that enables interaction with Apple Notes through natural language. It allows AI assistants like Claude to create, search, and retrieve notes from your iCloud Notes account using AppleScript integration. This server is for macOS users who want to manage Apple Notes programmatically via AI.

How to use Apple Notes MCP Server?

Install the server by cloning the repository, installing dependencies with Yarn, building with yarn build, and starting with yarn start on macOS with Node.js 20+ and the Apple Notes app configured. Then add the server to Claude Desktop’s claude_desktop_config.json using the yarn start command with the correct cwd path. After starting, the server exposes three tools: create note, search notes, and get note content.

Key features of Apple Notes MCP Server

• Create notes with title, content, and optional tags
• Search notes by title using powerful search capabilities
• Retrieve full content of any note by its exact title
• Works directly with your iCloud Notes account
• Integrates with AI assistants via Model Context Protocol

Use cases of Apple Notes MCP Server

• Quickly capture meeting notes or brainstorming ideas via AI
• Search for specific notes when you need to recall information
• Retrieve the full content of a saved note for review
• Automate note-taking workflows using natural language commands

FAQ from Apple Notes MCP Server

Is this server actively maintained?

No. The README includes a caution: "Not actively maintained. Use at your own risk!"

What are the prerequisites to run the server?

You need macOS with the Apple Notes app configured, Node.js version 20.0.0 or higher, and the Yarn package manager.

How do I configure the server with Claude Desktop?

Add an entry to your claude_desktop_config.json with the command set to "yarn", args set to ["start"], and cwd set to the absolute path of the cloned repository. You may need to authorize script access to Apple Notes when first running commands.

Does the server require iCloud?

Yes, it works directly with your iCloud Notes account. Ensure Apple Notes is properly configured with iCloud for best results.

What tools does the server provide?

It provides three tools: create note (parameters: title, content, optional tags), search notes (parameter: query), and get note content (parameter: title). All responses are text-based.