Apple Notes MCP
Provides tools for managing Apple Notes on macOS, including listing accounts, folders, notes, searching, creating, updating, appending, moving, and deleting notes and folders, as well as retrieving attachment metadata.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Apple Notes MCP show me my recent notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Apple Notes MCP
Comprehensive Apple Notes MCP server for local macOS note management.
Scope
This server exposes a full practical Apple Notes toolset across accounts, folders, notes, search, attachments, and destructive actions with explicit confirmation fields.
Account discovery
Folder listing/create/delete
Note listing/read/search/recent
Note create/update/append/move/delete
Attachment metadata listing
Related MCP server: better-bear
Prerequisites
macOS with Apple Notes app
Node.js 20+
Apple Notes content synced locally (iCloud/IMAP)
Setup
Install dependencies and build:
cd /Users/tyler/Projects/MCP-Servers/apple-notes-mcp
npm install
npm run buildAdd to MCP config (
~/.mcp.jsonor your client MCP config):
{
"mcpServers": {
"apple-notes": {
"command": "node",
"args": [
"/Users/tyler/Projects/MCP-Servers/apple-notes-mcp/dist/index.js"
]
}
}
}First run permission prompt:
On first use, macOS will prompt for Automation access so osascript can control Notes. Approve access.
Run
node /Users/tyler/Projects/MCP-Servers/apple-notes-mcp/dist/index.jsAvailable Tools
notes_list_accounts{}notes_list_folders{ account_id?, account_name? }notes_list_notes{ account_id?, account_name?, folder_id?, folder_name?, limit?, include_body? }notes_get_recent_notes{ days?, limit?, include_body? }notes_get_note{ note_id }notes_search_notes{ query, account_id?, account_name?, folder_id?, folder_name?, limit?, include_body?, case_sensitive? }notes_create_folder{ name, account_id?, account_name?, parent_folder_id?, parent_folder_name? }notes_delete_folder{ folder_id?, folder_name?, account_id?, account_name?, confirm, reason }(destructive)notes_create_note{ title?, body?, body_format?: "plain"|"html", account_id?, account_name?, folder_id?, folder_name? }notes_update_note{ note_id, title?, body?, body_format?: "plain"|"html" }notes_append_to_note{ note_id, content, content_format?: "plain"|"html", insert_blank_line? }notes_move_note{ note_id, target_folder_id?, target_folder_name?, account_id?, account_name? }notes_delete_note{ note_id, confirm, reason }(destructive)notes_list_attachments{ note_id }
Destructive Safety
Destructive operations require both:
confirm: truenon-empty
reason
This applies to:
notes_delete_notenotes_delete_folder
Notes
The server uses native Apple Notes scripting via
osascript -l JavaScript(JXA).Apple Notes does not need to be manually open. macOS auto-launches it when tools are called.
note_id,folder_id, andaccount_idare stable identifiers from Apple Notes and are recommended over names.Attachment file export is not provided by Notes scripting directly. This server returns attachment metadata.
License
MIT
Quickstart TL;DR
npm install
npm run build
node dist/index.jsAdd to MCP config:
{
"mcpServers": {
"apple-notes": {
"command": "node",
"args": ["/absolute/path/to/apple-notes-mcp/dist/index.js"]
}
}
}How It Works (TL;DR)
MCP client calls tool -> Node MCP server receives request
Server invokes native macOS JXA (
osascript -l JavaScript) against Apple NotesResponse is normalized into JSON and returned to the MCP client
Destructive operations require
confirm: trueandreason
LLM Quick Copy
Use the copy button on this code block in GitHub.
Repo: apple-notes-mcp
Goal: Local Apple Notes MCP server for macOS.
Setup:
1) npm install
2) npm run build
3) Add MCP config entry pointing to dist/index.js
4) Start your MCP client and call notes_list_accounts
How to use:
- Discover: notes_list_accounts, notes_list_folders, notes_list_notes
- Read/search: notes_get_note, notes_search_notes, notes_get_recent_notes
- Write: notes_create_note, notes_update_note, notes_append_to_note, notes_move_note
- Destructive: notes_delete_note / notes_delete_folder require confirm=true and reason
How it works:
- Node MCP wrapper -> JXA via osascript -> Apple Notes automation APIAvailable Tools
14 toolsnotes_append_to_noteB
Append content to an existing note by note_id. Supports plain text or HTML append mode.
Inputs: content (required), note_id (required), content_format, insert_blank_line.
notes_create_folderB
Create a folder in Apple Notes. You can target an account and optionally create it inside a parent folder.
Inputs: name (required), account_id, account_name, parent_folder_id, +1 more.
notes_create_noteC
Create a note in Apple Notes. Supports plain text or HTML body and optional title.
Inputs: body, title, folder_id, account_id, +3 more.
notes_delete_folderA
Delete a folder (destructive). Requires confirm=true and reason. Can be targeted by folder_id or folder_name (+ account scope).
Inputs: reason (required), confirm (required), folder_id, account_id, +2 more.
notes_delete_noteA
Delete a note (destructive). Requires confirm=true and reason.
Inputs: reason (required), confirm (required), note_id (required).
notes_get_noteA
Get a specific note by note_id with full HTML + text body.
Inputs: note_id (required).
notes_get_recent_notesB
List recently modified notes from the last N days.
Inputs: days, limit, include_body.
notes_list_accountsA
List all Apple Notes accounts available on this Mac.
Inputs: no named parameters.
notes_list_attachmentsA
List metadata for all attachments in a specific note.
Inputs: note_id (required).
notes_list_foldersA
List folders across Apple Notes. Optionally scope by account_id or account_name.
Inputs: account_id, account_name.
notes_list_notesC
List notes with optional scoping by account/folder and optional full body output.
Inputs: limit, folder_id, account_id, folder_name, +2 more.
notes_move_noteB
Move a note to another folder by note_id + target_folder_id/target_folder_name.
Inputs: note_id (required), account_id, account_name, target_folder_id, +1 more.
notes_search_notesB
Search notes by keyword across title, body, folder path, and account. Optionally scoped to account/folder.
Inputs: query (required), limit, folder_id, account_id, +4 more.
notes_update_noteA
Update an existing note by note_id. You can set title, body, or both. Body supports plain text or HTML.
Inputs: note_id (required), body, title, body_format.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have clearly distinct purposes: accounts, folders, notes, and attachments are separate concerns. There is mild overlap between list_notes, search_notes, and get_recent_notes, but the descriptions scope them well enough for an agent to choose correctly.
All tools share the notes_ prefix and follow a verb_noun pattern: list_, get_, search_, create_, update_, delete_, move_, append_to_. The naming is highly predictable and consistent across the entire set.
14 tools is well within the ideal range for a domain-specific MCP server. Each tool covers a meaningful operation on Apple Notes without unnecessary redundancy or bloat.
The core note lifecycle is well covered: create, read, update, append, move, search, list, and delete. Minor gaps exist around folder rename/update and attachments being metadata-only, but these are not severe dead ends.
Related MCP Connectors
Google Keep-style notes app with an MCP server for AI agents to read/write notes.
Search, read, and write your Apple Notes from ChatGPT/Claude via a local Mac agent + MCP relay.
Markdown-based note-taking with a hosted MCP server. Your notes serve you and your AI.
Notes, files, GitHub, and Drive through one MCP connection.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA production-ready MCP server for macOS that provides async, cache-backed access and background queued writes to Apple Notes. It enables seamless integration for reading, creating, and managing notes through standard tools like ScriptingBridge while supporting background service execution.MIT
- AlicenseAqualityCmaintenanceMCP server for Bear notes via CloudKit. Full CRUD, tags, search, TODOs, attachments, and a context library for curated LLM knowledge bases.3568MIT
- AlicenseBqualityCmaintenanceMCP server for macOS Apple apps. Enables read/write access to Notes, Reminders, Calendar, Contacts, and Safari using SQLite and JXA, all running locally.2817 npm4MIT
- AlicenseAqualityBmaintenanceAn MCP server that enables LLM agents to list, read, create, update, delete, and search Apple Notes on macOS.613 npmAGPL 3.0