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 備忘錄資料庫：尋找資料、撰寫或附加備忘錄、整理資料夾，同時仍以備忘錄 App 為準。它是比一體式 Apple 伺服器更聚焦、隔離更強的備忘錄專用方案。
執行需求
僅在 macOS 本機執行，透過 uvx 從 PyPI 以 stdio 啟動（複製原始碼方式需 Python 3.11+），或使用提供的 MCP 安裝包。需要授予備忘錄的 macOS 自動化權限。可選環境變數用於設定帳號與資料夾允許清單及安全模式。
安裝前請注意
它可以建立、更新、移動與刪除備忘錄和資料夾，應謹慎設定安全模式與允許清單；README 範例設定使用 full_access。備忘錄內文會經備忘錄 App 讀取並回傳給助理。建立逾時可能導致結果不明，重試前應先檢查目標資料夾。

安裝

在 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 分