mcpbeat Sign in

Apple Notes MCP Server

local only

Apple Notes runs on your own machine — the client starts it, so there is no endpoint to ping. 1 372 installs a week from npm. Last commit 9 Sep 2026.

Search, read and act on Apple Notes — folders, attachments, writes off by default

Installs per day peak 481 · avg 68 · +293% w/w
a month agotoday
1 372
Installs / week
npm · @mgcrea/mcp-apple-notes
2
Stars
2 open issues
9 Sep 2026
Last commit
0 releases in 90 days
MIT
License
TypeScript

What the code does

We read the source, 17 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

    return execSync(cmd, { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"] }).trim();
Dumps the whole environment apps/apple/tsdown.servers.config.ts:76
    __GIT_COMMIT__: JSON.stringify(process.env.GIT_COMMIT || tryGit("git rev-parse --short HEAD")),

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add mcp-apple-notes -- npx -y @mgcrea/mcp-apple-notes
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "command": "npx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.mcp-apple-notes]
command = "npx"
args = ["-y", "@mgcrea/mcp-apple-notes"]
.cursor/mcp.json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "command": "npx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "mcp-apple-notes": {
      "args": [
        "-y",
        "@mgcrea/mcp-apple-notes"
      ],
      "command": "npx"
    }
  }
}

Alternatives to Apple Notes

same job, measured the same way
Apple Mail
by mgcrea

Search, read and act on Apple Mail — threads, attachments, body search, writes off by default

1 241 installs/wk local only
Apple Reminders
by mgcrea

Search, read and act on Apple Reminders — lists, due dates, writes off by default

1 222 installs/wk local only
Apple Maps
by mgcrea

Read and act on Apple Maps — favourites, Guides and recents, writes off by default

1 418 installs/wk local only
Apple Calendar
by mgcrea

Search, read and act on Apple Calendar — ranges, free-time lookup, writes off by default

1 383 installs/wk local only
Apple Contacts
by mgcrea

Search and read Apple Contacts — resolves numbers and emails to names, writes off by default

1 401 installs/wk local only
Apple Safari
by mgcrea

Read and act on Safari — history, tabs and reading list, writes off by default

1 206 installs/wk local only
IMAP mailbox
by ni-c

Read, search and organise any IMAP mailbox, with writes off by default

265 installs/wk local only
Apple Messages
by mgcrea

Search and read Apple Messages — chats and decoded text, sending off by default

1 423 installs/wk local only

Apple Notes — questions

Answers built from our own checks of this server.

Why is there no uptime for Apple Notes?
Apple Notes runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @mgcrea/mcp-apple-notes was installed 1 372 times last week.
How do I connect Apple Notes?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @mgcrea/mcp-apple-notes straight from npm; nothing to host, nothing to sign up for.
How many people use Apple Notes?
The npm package @mgcrea/mcp-apple-notes was installed 1 372 times in the last week. Week over week that is +293%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Apple Notes open source?
Yes — it is published under the MIT licence, written in TypeScript, 2 stars on GitHub and 2 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.