Guide · Apple Notes MCP

Apple Notes MCP: Setup Guide + Best Servers (2026)

You have a folder in Notes called “Misc” with 200 notes in it. You know what you need is in there, but you don’t remember what you titled it, and Notes search only matches words that are on the page.

Apple Notes MCP fixes the finding half of that. It lets an AI assistant like Claude read your notes, so you can ask for the three you need instead of scrolling through 200. It works on a Mac only, and one server covers most uses.

Quick answer
  • There is no official server. Apple has not built one, and everything here is community work.
  • sweetrb/apple-notes-mcp is the one to install. Actively maintained, 40-plus tools, one command to set up.
  • macOS only. Both servers depend on AppleScript or JXA, which do not exist on Windows or iPadOS. Everything runs locally on your Mac.
  • They only reach Notes. ContextBolt covers your X, Reddit and LinkedIn saves, and keeps them on your own device on the free tier, and syncs a copy on Pro.

Which Apple Notes MCP server should you use?

Search “apple notes mcp” and you get a scattering of small repos, most of them abandoned after a weekend. That’s normal for a single-app MCP server. The OneNote servers are the extreme case, where the three most-starred options all stopped shipping in 2025. Two Apple Notes servers are worth a look, and they do different jobs.

sweetrb/apple-notes-mcpRafalWilinski/mcp-apple-notes
DoesReads, writes and organizes notesSemantic search over notes you already have
MaintainedYes, 270-plus commitsNo commits since December 2024, 21 open issues
InstallOne npx command, Node 20 or laterBun and a manual clone, not a published package
SearchKeyword and metadataEmbeddings in a local LanceDB index

sweetrb/apple-notes-mcp exposes more than 40 tools. They cover create, search, read, update, delete, move and append, folders with nested paths, multiple Notes accounts (iCloud, Gmail, Exchange), batch delete and move, export to JSON or Markdown, and attachments. It talks to Notes through AppleScript, with optional Full Disk Access for a few database-backed features like checklist state and sync diagnostics.

RafalWilinski/mcp-apple-notes reads your notes through JXA, generates embeddings with the all-MiniLM-L6-v2 model, and stores them in a local LanceDB vector database. That gives you real semantic search rather than a keyword match. It was an influential proof of concept when it shipped in December 2024, with 410 GitHub stars to show for it, and it is read-focused rather than built for writing notes. Notes come back as raw HTML rather than Markdown, which the project’s own README lists as an unfinished todo.

For nearly everyone, sweetrb’s does more, breaks less often, and is still getting fixed when macOS changes underneath it. RafalWilinski’s suits you if you want to see how semantic search over a local note store works, or to fork and finish. Stalled servers rank by star count long after the fact. Tana’s most-linked community server was archived in August 2026 and still tops every listing.

Set it up in Claude Desktop or Claude Code

Anthropic introduced MCP in late 2024 as a common way for AI clients to call local tools, and these servers use it to reach Notes. This covers sweetrb/apple-notes-mcp. You need a Mac, and Node 20 or later (run node -v in Terminal to check).

  1. Claude Desktop: go to Settings, then Developer, then Edit Config. That opens claude_desktop_config.json, normally at ~/Library/Application Support/Claude/claude_desktop_config.json. Add this block.
{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "apple-notes-mcp"]
    }
  }
}
  1. Claude Code instead: run claude mcp add apple-notes -- npx -y apple-notes-mcp in a terminal. It writes the config for you, and the server is there in your next session.
  2. Restart fully. Quit Claude Desktop with Cmd-Q instead of closing the window, then reopen it. A window reload does not reconnect MCP servers.
  3. Approve the automation prompt. The first time a tool runs, macOS asks whether to let the process control Notes. Click Allow. If every call fails silently later, this permission is almost always why.
  4. Test it. Ask “list my 10 most recent notes.” Titles and snippets coming back means it works.

You probably won’t need Full Disk Access. It’s only for the database-backed features, and it’s a broad permission, so grant it to your terminal app or Claude Desktop under System Settings, then Privacy & Security, only if you want them.

What to ask once it’s connected

  • Find the note, not the title: “Which of my notes mentions the wifi password for my parents’ house?” Notes can’t do this search because it needs something to read every note rather than match a string.
  • Summarize a messy folder: “What’s in my Misc folder, grouped by topic?”
  • Draft directly into Notes: “Write a packing list for a four-day trip and save it as a new note in my Travel folder.” The write tools put the note in the app itself.
  • Find duplicates: “Find notes that look like near-duplicates and list them.”
  • Turn a brain dump into a checklist: “Take my ‘ideas’ note and make a checklist of what’s actionable this week.”

What it can’t do

It only sees what is in Notes. A screenshot you never transcribed, or a note you deleted six months ago, is out of reach. Attachments are listed and fetched, not analyzed, unless you separately ask Claude to look at the image.

It needs a Mac. If your notes live on an iPhone with no Mac nearby, this is unavailable until you’re back at a Mac with Notes syncing through iCloud.

The maintained server has no semantic search. Its search is closer to full-text and metadata matching than embeddings-based ranking. For vector search, RafalWilinski’s approach is the right idea, just not the maintained implementation.

Automation permissions can drop. macOS sometimes revokes them after an update. If a working setup suddenly returns empty results, check System Settings, then Privacy & Security, then Automation, before blaming the server.

Is it safe to connect Apple Notes to Claude?

Both servers run on your machine and only touch Notes when a tool is called. Nothing uploads automatically. The risk is the one every local MCP server carries: you’re trusting the code that runs, so stick to servers with visible source and recent activity. Treat anything you ask Claude to quote back to you the way you’d treat pasting it into a chat window.

What ContextBolt covers instead

ContextBolt has no connection to Apple Notes. Notes holds what you typed on purpose. ContextBolt holds what you saved without typing anything: the tweets, Reddit threads and LinkedIn posts you bookmarked in passing. It tags them by topic, and Pro adds its own MCP endpoint so Claude can search that pile the way it searches your Notes.

Basic is free and capped at 150 bookmarks, with AI tagging and instant local search. Pro is $6 a month, removes the cap, and adds cloud sync and the MCP endpoint. For the broader picture of connecting your own tools to Claude, see What Is MCP? The Plain English Explainer and the MCP server directory.

Where next

Frequently asked questions

Something else on your mind? Get in touch.

What is Apple Notes MCP?

It is a small server that lets an AI assistant read, search, or write your Apple Notes through the Model Context Protocol. Once connected, Claude can find a note by what it says rather than what it is called, summarize a folder, or draft a new note directly into your Notes app.

Is there an official Apple Notes MCP server?

No. Apple has not shipped one, and nothing in Notes or iCloud settings mentions MCP. Every server that exists is community-built, and the people discussing them do so on GitHub, Reddit, and independent blogs, not in any Apple documentation.

Does Apple Notes MCP work on Windows or iPad?

No. Both servers covered here connect through AppleScript or JXA, which only run on macOS. There is no equivalent automation layer for Notes on Windows, iPadOS, or the web version of Notes. If your notes only exist on an iPhone or iPad, you need a Mac in the loop somewhere.

Which Apple Notes MCP server should I use?

sweetrb/apple-notes-mcp for almost everyone. It is actively maintained, covers reading, writing, folders, attachments, and batch operations, and installs in one command. RafalWilinski/mcp-apple-notes is worth knowing about for its semantic search approach, but the repository has not been updated since December 2024.

Is it safe to connect Apple Notes to Claude?

Both servers run entirely on your machine and only touch the Notes app when a tool is called. Nothing uploads automatically. The risk is the same as any local MCP server. You are trusting the code that runs, so stick to servers with visible source and recent activity, and treat anything you ask Claude to quote back to you the same way you would treat pasting it into a chat window.