Apple Notes

io.github.JonathanRReed由 GitHub 账号 JonathanRReed 发布v1.1.6更新于 Nov 7, 2026

Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.

已验证STDIO仅桌面效率与工作流文件与存储

概览

AI 生成的概览

本地 macOS MCP 服务器，让助手读取、搜索、创建、编辑、移动和删除 Apple 备忘录及文件夹。

可以做什么
  • 列出账户、文件夹和备忘录，并按 id 获取单条备忘录
  • 按文本、文件夹或账户搜索备忘录，并列出备忘录附件
  • 创建、更新、追加内容、移动和删除备忘录
  • 创建、重命名和删除文件夹，包括嵌套文件夹
  • 检查配置、说明 macOS 自动化权限并重新检查访问权限
  • 按关键词检索本服务器自身的工具并加载某个工具的完整结构
适用场景
适合在 Mac 上让助手处理已有的 Apple 备忘录库：查找资料、起草或追加备忘录、整理文件夹，同时仍以备忘录应用为准。它是比一体化 Apple 服务器更聚焦、隔离更强的备忘录专用方案。
运行要求
仅在 macOS 本地运行，通过 uvx 从 PyPI 以 stdio 启动（克隆方式需 Python 3.11+），或使用提供的 MCP 安装包。需要授予备忘录的 macOS 自动化权限。可选环境变量用于设置账户与文件夹白名单及安全模式。
安装前请注意
它可以创建、更新、移动和删除备忘录与文件夹，应谨慎设置安全模式和白名单；README 示例配置使用 full_access。备忘录正文会经备忘录应用读取并返回给助手。创建超时可能导致结果未知，重试前应先检查目标文件夹。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Apple Notes，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Apple Notes MCP

MCP server for Apple Notes on macOS.

Provides access to notes and folders for creation, organization, and management. Keep Notes as the system of record while enabling agents to read, create, update, move, and delete notes.

When to use

  • Notes-only workflows
  • Stronger isolation than the all-in-one server
  • Structured note and folder operations through the native Notes app

What It Does

  • List accounts and folders
  • List, search, and manage notes (CRUD)
  • Create, rename, and delete folders
  • List note attachments
  • Tool discovery helpers search_tools and get_tool_info for context-constrained clients
  • Recent-note resources and organization prompts
  • Health and permission checks: notes_health, notes_permission_guide, notes_recheck_permissions

Install On This Mac

Quick start (uvx, from PyPI)

With uv installed:

bash
uvx apple-mcp-notes

No clone, no venv management.

From a clone
bash
git clone https://github.com/JonathanRReed/Apple-MCPs.gitcd Apple-MCPsuv sync --all-packages

This builds one workspace environment with every server's entry point in .venv/bin (for example .venv/bin/apple-notes-mcp). You can also point an MCP client at AppleNotes-MCP/start.sh, which prefers uv run and falls back to a plain venv bootstrap (Python 3.11+ required).

Install In AI Agents

Generic MCP client config
json
{  "mcpServers": {    "apple-notes": {      "command": "uvx",      "args": ["apple-mcp-notes"],      "env": {        "APPLE_NOTES_MCP_SAFETY_MODE": "full_access"      }    }  }}

Running from a clone instead? Use /path/to/Apple-MCPs/AppleNotes-MCP/start.sh as the command with empty args.

Claude Code example
bash
claude mcp add --transport stdio --scope user apple-notes -- uvx apple-mcp-notes

--scope user makes the server available in every project. To share it with one repository through its .mcp.json instead, use --scope project.

Safety Modes

  • safe_readonly
  • safe_manage
  • full_access

Transport

stdio is the default and recommended transport. Set APPLE_NOTES_MCP_TRANSPORT=streamable-http (with optional APPLE_NOTES_MCP_HOST and APPLE_NOTES_MCP_PORT) to serve Streamable HTTP instead.

Reading and Searching Notes

List and search results include available note plaintext, so search can match body text as well as titles and tags. Note properties are read in Notes.app's AppleScript context. Folder metadata is resolved at most once per listing request when it is missing from a note payload.

Literal control characters and complex emoji returned by Notes are decoded on the Python side without changing their text. Locked or unavailable note fields can still be empty; Automation access remains required.

Script Timeout

Every AppleScript call is bounded by APPLE_NOTES_MCP_SCRIPT_TIMEOUT_SECONDS (default 60, minimum 5) so a stalled Notes.app can never hang an MCP request indefinitely. A create timeout returns NOTE_CREATE_STATUS_UNKNOWN. A matching title and creation time cannot establish which operation created a note, so the server leaves matching notes untouched. Inspect the target folder before retrying. Note timestamps use an absolute UTC Unix epoch.

macOS Permissions

  • Automation access to Notes is required

Launch Checklist

  • Add uvx apple-mcp-notes (or a clone's AppleNotes-MCP/start.sh) to your MCP client
  • Reload or reconnect the client so the Notes tool surface is loaded into context
  • Call notes_health first
  • If Notes automation is blocked, call notes_permission_guide
  • After changing macOS permissions, call notes_recheck_permissions

Prompting Notes

  • tools/list returns the full Notes tool surface. Context-constrained clients can use search_tools first, then get_tool_info for the Notes tool they need.
  • Multiple accounts may each contain a Notes folder. Identify available accounts and folders on first use and set a default.
  • Use Notes for reference material and saved context.
  • Time-sensitive items should go to Reminders or Calendar instead.

Related

来源：AppleNotes-MCP/README.md，提交 9aeaa81

工具

21

notes_health

Notes Health

Report the active Apple Notes MCP configuration.

无需输入参数。

notes_permission_guide

Notes Permission Guide

Explain how to grant Apple Notes automation permission on macOS.

无需输入参数。

notes_recheck_permissions

Notes Recheck Permissions

Recheck Notes access after the user changes macOS permissions, and notify the client that Notes resources changed.

无需输入参数。

notes_list_accounts

List Accounts

List Apple Notes accounts.

无需输入参数。

notes_list_folders

List Folders

List Apple Notes folders.

输入参数limitoffsetaccount_name

notes_list_notes

List Notes

List notes, optionally scoped to a folder or account.

输入参数limitoffsetfolder_idaccount_name

notes_get_note

Get Note

Fetch full details for an Apple Notes note by note_id.

输入参数note_id必填

notes_search_notes

Search Notes

Search notes by text, folder, or account.

输入参数limitquery必填offsetfolder_idaccount_name

notes_create_note

Create Note

Create a new note in a folder.

输入参数tagstitle必填body_htmlfolder_id必填

notes_update_note

Update Note

Update an existing note.

输入参数tagstitlenote_id必填body_htmlfolder_id

notes_append_to_note

Append to Note

Append text to an existing note without replacing its current content. Provide body_text for plain text or body_html for rich content.

输入参数note_id必填body_htmlbody_text

notes_delete_note

Delete Note

Delete a note by note_id.

输入参数note_id必填

notes_move_note

Move Note

Move a note to a different folder.

输入参数note_id必填folder_id必填

notes_create_folder

Create Notes Folder

Create a new folder in an Apple Notes account or nested folder.

输入参数folder_name必填account_name必填parent_folder_id

notes_rename_folder

Rename Folder

Rename an existing folder.

输入参数folder_id必填folder_name必填

notes_delete_folder

Delete Folder

Delete an Apple Notes folder.

输入参数folder_id必填

notes_list_attachments

List Note Attachments

List attachments for a note.

输入参数note_id必填

notes_list_prompts

Notes List Prompts

Fallback prompt discovery tool for tool-only MCP clients.

无需输入参数。

notes_get_prompt

Notes Get Prompt

Fallback prompt rendering tool for tool-only MCP clients.

输入参数name必填arguments_json

search_tools

Search Tools

Search this server's tool catalog by keyword, alias, or domain tag.

输入参数modelimitquery必填domain_tags

get_tool_info

Get Tool Info

Load the full schema, examples, and metadata for one tool from this server.

输入参数name必填include_schemainclude_examples

版本历史

8
  1. v1.1.6最新Nov 6, 2026
  2. v1.1.4Oct 29, 2026
  3. v1.1.3Oct 22, 2026
  4. v1.1.2Oct 14, 2026
  5. v1.1.1Oct 13, 2026
  6. v1.1.0Oct 10, 2026
  7. v1.0.5Sep 26, 2026
  8. v1.0.4Sep 16, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分