How do I connect Apple Notes MCP Server to Claude?

The listing records `claude mcp add apple-notes -s user -- npx -y apple-notes-mcp` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, VS Code as compatible clients.

Is Apple Notes MCP Server free?

The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.

What can Apple Notes MCP Server do?

Apple Notes MCP Server documents 36 tools to the agent, including append-to-note, batch-delete-notes, batch-move-notes. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.

Apple Notes MCP

Unclaimed

by sweetrb

MCP server for Apple Notes - read, search, create, edit, organize, and export notes on macOS via Claude and other AI assistants

Install

$claude mcp add apple-notes -s user -- npx -y apple-notes-mcp

Set up this server

Compare servers My Stack

This server needs project-specific setup. Follow the project instructions; no reusable public launch command is available yet.

Project instructions

aiappleapple-notesapple-shortcutsapplescriptclaudecodexmacosmcpmodel-context-protocolnotes

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Security profile

Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works

36 of 36 tools

Documented tools (36)

From project documentation. A server handshake does not verify each tool’s description or behavior.

append-to-note

Appends or prepends content to an existing note without replacing it. Always reads and writes as HTML, preserving all existing rich formatting.

batch-delete-notes

Deletes multiple notes at once by ID.

batch-move-notes

Moves multiple notes to a folder.

create-folder

Creates a new folder, including a whole nested hierarchy in one call.

create-note

Creates a new note in Apple Notes.

delete-folder

Deletes a folder.

delete-note

Deletes a note (moves to Recently Deleted in Notes.app).

doctor

Run a full setup diagnostic: Notes.app reachability, the Automation permission, configured accounts, and Full Disk Access — each reported as ok / warn / fail with an actionable message. This is the richer counterpart to health-check; reach for it first when something isn't working.

export-notes-json

Exports all notes as a JSON structure.

fetch-attachment

Returns a note attachment's bytes as base64, without writing to disk (the read counterpart to save-attachment).

get-checklist-state

Reads checklist done/undone state for a note. This bypasses the AppleScript limitation where body of note strips checklist state, by reading directly from the NoteStore SQLite database.

get-default-location

Returns the default account and folder Notes.app uses for newly created notes.

get-note

metadata (BETA)

get-note-by-id

Retrieves a note using its unique CoreData identifier.

get-note-content

Retrieves the full content of a specific note.

get-note-details

Retrieves metadata about a note (without full content).

get-note-link

Returns the notes://showNote?identifier=<uuid> deep-link URL for a note. The URL opens the note in Notes.app on iOS and macOS and can be stored in Reminders tasks or shared links.

get-note-markdown

Gets a note's content as Markdown instead of HTML. If the note contains checklists and Full Disk Access is granted, checklist items are automatically annotated with [x] (done) or [ ] (undone).

get-note-plaintext

Retrieves a note's body as plain text, with no HTML markup.

get-notes-stats

Gets comprehensive statistics about your notes.

get-selected-notes

Reads the currently selected note(s) from the Notes.app UI.

get-sync-status

Checks iCloud sync status.

health-check

Verifies Notes.app connectivity and permissions.

list-accounts

Lists all configured Notes accounts.

list-attachments

Lists attachments in a note.

list-folders

Lists all folders in an account with full hierarchical paths.

list-notes

Lists all notes, optionally filtered by folder, date, and limit.

list-shared-notes

Lists all notes shared with collaborators.

move-note

Moves a note to a different folder. The note is relocated in place via Notes.app's native move, so its id, creation date, and all embedded attachments (files, images, scans, PDFs, audio) are preserved. The destination folder must already exist — create it first with create-folder.

save-attachment

Saves a note attachment to disk.

search-notes

Searches for notes by title or content.

show-account

Reveals an account in Notes.app using its unique CoreData identifier.

show-attachment

Reveals one note attachment in Notes.app. Attachments are elements of a note, so this takes both the note id and the attachment id (the same pair used by save-attachment / fetch-attachment).

show-folder

Reveals a folder in Notes.app using its unique CoreData identifier.

show-note

Reveals a note in Notes.app using its unique CoreData identifier.

update-note

Updates an existing note's content and/or title.

Tool change history

Compared across complete checks of the same configuration. Tools were listed, not invoked. Input-schema changes are not measured here.

No complete tool checks yet.

FAQ

Questions about Apple Notes MCP Server

How do I connect Apple Notes MCP Server to Claude?: The listing records `claude mcp add apple-notes -s user -- npx -y apple-notes-mcp` as its setup step. Run it, then follow the repository's instructions for the client configuration; the listing names Claude Desktop, Claude Code, VS Code as compatible clients.
Is Apple Notes MCP Server free?: The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
What can Apple Notes MCP Server do?: Apple Notes MCP Server documents 36 tools to the agent, including append-to-note, batch-delete-notes, batch-move-notes. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.