Skip to main content
Glama
Apple Notes MCP
by tszaks

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

  1. Install dependencies and build:

cd /Users/tyler/Projects/MCP-Servers/apple-notes-mcp
npm install
npm run build
  1. Add to MCP config (~/.mcp.json or your client MCP config):

{
  "mcpServers": {
    "apple-notes": {
      "command": "node",
      "args": [
        "/Users/tyler/Projects/MCP-Servers/apple-notes-mcp/dist/index.js"
      ]
    }
  }
}
  1. 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.js

Available 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: true

  • non-empty reason

This applies to:

  • notes_delete_note

  • notes_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, and account_id are 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.js

Add 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 Notes

  • Response is normalized into JSON and returned to the MCP client

  • Destructive operations require confirm: true and reason

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 API

Available Tools

14 tools
notes_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

    A3.5/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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