Apple Notes Mcp Server

What is Apple Notes MCP Server?

A server that lets AI agents read, write, and manage Apple Notes with native formatting support, using macOS's built-in Markdown import to preserve styles like headings, bold, and lists. It requires macOS 26 (Tahoe) or later and Node.js 24+.

How to use Apple Notes MCP Server?

Add to your MCP client configuration (e.g., Claude Desktop or Claude Code) with the command npx -y @ailenshen/apple-notes-mcp@latest, then grant Full Disk Access and Accessibility permissions to node in System Settings. Use natural language commands to interact with your notes. For remote access, run with the --http flag.

Key features of Apple Notes MCP Server

• Read and write Apple Notes with native formatting.
• Fast SQLite-based listing and searching.
• Remote access via HTTP mode with built-in secret.
• Automatic permission detection and fix guidance.
• Native Markdown import for styled notes.
• Delete notes by moving to Recently Deleted.

Use cases of Apple Notes MCP Server

• Browse and search your Apple Notes from an AI assistant.
• Create natively formatted notes using Markdown.
• Update and manage notes across folders.
• Access Apple Notes remotely from another device.
• Delete old notes programmatically.

FAQ from Apple Notes MCP Server

What makes this server different from other Apple Notes MCP servers?

Most Apple Notes MCP servers can only write plain text. This server creates natively formatted notes—titles, headings, bold, and lists render as real Apple Notes styles, not plain text.

What are the runtime requirements?

macOS 26 (Tahoe) or later and Node.js 24+ are required.

Where does note data live?

Notes are stored locally in the macOS Notes database and sync via iCloud naturally; the server reads the database directly for listing and searching.

Does the server support partial note editing?

No. update_note always replaces the full content because Apple Notes exposes content via AppleScript as HTML, not original Markdown, so a clean read→edit→write round-trip isn't possible.

What permissions does the server need and how are they handled?

Full Disk Access and Accessibility for node are required. The server automatically detects missing permissions and tells you exactly which one to enable and how to fix it.