Apple Notes Mcp Server
@ailenshen
About Apple Notes Mcp Server
Read and write Apple Notes, with Apple Notes native formatting support
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"apple-notes": {
"command": "npx",
"args": [
"-y",
"@ailenshen/apple-notes-mcp@latest"
]
}
}
}Tools
6List notes from Apple Notes. Returns title, folder, dates, pinned status, snippet. Optionally filter by folder name and limit results.
Search Apple Notes by keyword. Searches in title and snippet. Returns matching notes with metadata.
Get the full content of a note by its title, returned as Markdown. Optionally specify folder to disambiguate.
Create a new note in Apple Notes from Markdown content. The first line becomes the title. Optionally specify a target folder (defaults to 'Notes').
Update an existing note in Apple Notes. Deletes the old note and creates a new one with the given Markdown content, preserving the original folder.
Delete a note from Apple Notes by title. Optionally specify folder to disambiguate. The note is moved to Recently Deleted.
Overview
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.
Frequently asked questions
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.
Basic information
More Memory & Knowledge MCP servers
Notion MCP Server
suekouA Model Context Protocol server for connecting Notion to MCP-compatible clients
Obsidian MCP Server
StevenStavrakisA simple MCP server for Obsidian
ctxfile
ctxfileLocal-first MCP server that snapshots your project's working state into one context object. Open-core, privacy-first.
Rust Docs MCP Server
Govcraft🦀 Prevents outdated Rust code suggestions from AI assistants. This MCP server fetches current crate docs, uses embeddings/LLMs, and provides accurate context via a tool call.
Notion MCP Server
makenotionOfficial Notion MCP Server
Comments