Apple Notes Mcp Server

Name: Apple Notes Mcp Server
Author: ailenshen

@ailenshen

代码仓库

关于 Apple Notes Mcp Server

Read and write Apple Notes, with Apple Notes native formatting support

基本信息

分类

记忆与知识

许可证

MIT

运行时

node

传输方式

stdio

发布者

ailenshen

提交者

Ailen

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@ailenshen/apple-notes-mcp@latest"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

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.