原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。评价和账户功能将在后续阶段推出。
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

Apple Notes

作者:mgcrea版本 1.37.0i★ –i在你的电脑上运行
注册名称io.github.mgcrea/mcp-apple-notes

安装

概览

作者提供的说明(英文原文)

Search, read and act on Apple Notes — folders, attachments, writes off by default

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数:意见、测量和人气是不同的东西。

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

  • 连接方式: 在你的电脑上运行
  • 传输方式: stdio
  • 分类: 文档、表格与办公

安装

选择你使用的 AI 应用,然后复制设置。

安装之前

  • 基础检查:1 项中通过 1 项
  • 在你的电脑上运行,拥有你的用户账户的权限(文件、网络、应用)。
  • 需要你自己填写: APPLE_NOTES_ALLOW_WRITES, APPLE_NOTES_ACCOUNTS

你需要

  • npm已安装 Node.js(用于 npx 命令)

你用的是哪个应用?

在上方选择你的应用。我们会记住它,下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config,把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "env": {
        "APPLE_NOTES_ALLOW_WRITES": "your-value",
        "APPLE_NOTES_ACCOUNTS": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add apple-notes --env APPLE_NOTES_ALLOW_WRITES=your-value --env APPLE_NOTES_ACCOUNTS=your-value -- npx -y @mgcrea/mcp-apple-notes

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json,或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "env": {
        "APPLE_NOTES_ALLOW_WRITES": "your-value",
        "APPLE_NOTES_ACCOUNTS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "apple-notes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "env": {
        "APPLE_NOTES_ALLOW_WRITES": "your-value",
        "APPLE_NOTES_ACCOUNTS": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用,然后应用会显示设置并请你确认。密钥的值会留空,由你自己填写。

这个服务器在你的电脑上运行,而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上,无需账户。

需要你填写的值

  • APPLE_NOTES_ALLOW_WRITES env
    Register the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.
  • APPLE_NOTES_ACCOUNTS env
    Restrict every read and write to these Notes accounts, by name.

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。

它能做什么

它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月7日

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 mgcrea 验证,该账户拥有此仓库

  • … 尚未检查

    仍在维护

    我们还没有从 GitHub 读取这个仓库

  • … 尚未检查

    有许可证

    我们还没有从 GitHub 读取这个仓库

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

与“文档、表格与办公”中的其他服务器比较i

  • 星标数多于此分类中其他 2193 个服务器的 0%
  • 发布到注册中心的时间比此分类中其他 2193 个服务器的 95% 更新
  • 基础检查结果等于或优于此分类中其他 2193 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。

常见问题

Apple Notes 安全吗?

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。

它需要哪些密钥或代码?

注册中心没有列出必需的密钥,不过有些服务器会在首次使用时要求你登录。

它在我的电脑上运行还是在云端?

它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。

它还在维护吗?

GitHub 仓库最后更新于–,最新版本(1.37.0)于昨天进入注册中心。

哪些应用可以使用它?

支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js。

有什么可以替代它?

同一分类中有:Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

替代选择

同一分类中其他作者的服务器,按星标数排序。

如何看卡片:★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Agent-Native Calendar

作者:BuilderIO

Agent-Native Google Calendar - manage events, sync, and public booking

在云端运行★ 7,620MIT2个月前更新
安装

Excel MCP Server

作者:haris-musa

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

在你的电脑上运行★ 4,276MIT6天前更新
安装

MCP Server for Excel

作者:sbroenne

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

在你的电脑上运行★ 847MIT4天前更新
安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

@mgcrea/mcp-apple-notes

Model Context Protocol server for the macOS Apple Notes app.

Unofficial. Not affiliated with Apple. It drives the Notes app that is already on your Mac.

Two lanes

  • Apple Events lane — accounts, folders, bodies, and every mutation. Always the authority: after a write, the result is what Notes re-read.
  • Index lane — read-only SQLite over NoteStore.sqlite, for search and metadata at a scale Apple Events cannot reach. Needs Full Disk Access.

Unlike Mail, the Apple Events lane alone is a working server. Measured on a 921-note library, a full-text search takes 97 ms — against the 74 s that forced Mail onto its index. So you can install this, use it, and only then decide whether to grant Full Disk Access.

It does not scale for ever: there is no index behind it, so every query pays the full cost again. The wall is around 5–10k notes. apple_notes_diagnostics tells you which lane is answering.

PermissionNeeded forWithout it
Automation → Noteseverythingnothing works; you get a -1743 error
Full Disk Accesssearch at scale, save_attachmentthe server still runs, on the Apple Events lane

Neither is granted to Notes.app — it is the _reader_ that needs permission.

Tools

Read: diagnostics, list_accounts, list_folders, list_notes, search_notes, get_note, list_attachments, save_attachment.

Write, registered only when APPLE_NOTES_ALLOW_WRITES=1 — with the flag off they are invisible to the model, not merely refused: create_note, update_note, move_note, delete_notes, add_attachment.

add_attachment is the only way to put an image in a note. An tag in a note's body creates an attachment whose bytes Notes never loads — see docs/notes.md.

Configuration

VariableDefault
APPLE_NOTES_ALLOW_WRITESoffRegister the mutating tools.
APPLE_NOTES_ACCOUNTSallRead-side allowlist, comma-separated.
APPLE_NOTES_INDEX_MODEautoauto \ro \immutable \off.
APPLE_NOTES_STOREautoExplicit NoteStore.sqlite path.
APPLE_NOTES_SEARCH_CACHE_TTL_MS60000How long the body corpus stays warm.
APPLE_NOTES_ATTACHMENT_DIR~/DownloadsThe only directory attachments may be saved into.
APPLE_NOTES_BODY_MAX_BYTES262144Body truncation, to protect the context window.
APPLE_NOTES_OSASCRIPT_TIMEOUT_MS30000Sized for the first-run permission prompt.

Notes that will bite you

  • Notes takes a note's title from the first line of its body. Setting name is silently ignored, so create_note prepends the title as a heading instead.
  • Password-protected notes cannot be read at all. Their text is AES ciphertext at rest, which is why ZICNOTEDATA carries crypto columns; no permission makes it readable.
  • Folders nest. A folder map has to recurse even if your own library happens to be flat.
  • Search caches on a TTL, not on invalidation. Checking whether the cache is stale costs _more_ over Apple Events (128 ms) than redoing the scan (97 ms), so bounded staleness is the honest trade. See docs/notes.md.

Licence

MIT.

问 PopNx