sweetrb / apple-notes-mcp
MCP server for Apple Notes - read, search, create, edit, organize, and export notes on macOS via Claude and other AI assistants
Why this job: name: mcp; says: mcp server; topics: model-context-protocol, mcp
What it does
A Model Context Protocol (MCP) server that lets Claude (Claude Code and Claude Desktop), Codex, and other MCP clients read, search, create, edit, organize, and export notes in Apple Notes on macOS. It runs locally on your Mac and talks to Notes through AppleScript, Apple Shortcuts, and read-only access to the Notes database.
Get started
npx -y apple-notes-mcp setup --gemini-sparknpx -y [email protected] setup --native-helper
npx -y [email protected] setup --native-helper --checkYou need: macOS with Notes.app and at least one configured Notes account. Features depend on the installed macOS version and account type; inspect get-capabilities before relying on optional features.; Node.js 20 or newer. The npx examples also need npm, normally included with Node.js.; A client that can launch a local stdio MCP server on this Mac. The configurations below cover Claude Code, Claude Desktop, Codex, Hermes, and Antigravity.
- Maintenance
- Active
- Last commit yesterday
- Stars
- 183
- +8 this week
- Licence
- MIT
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- v2.16.1
- Released yesterday
- Built with
- TypeScript
- 52% of the code
Is it looked after?
- Contributors
- 3
- Last 90 days
- Issues
- 96% closed
- 2 still open
- Pull requests
- 240 merged
- 0 waiting
- Releases
- 154
- 30+ in the last year
- Contributing guide (opens in new tab)
- Security policy (opens in new tab)
- No code of conduct
Similar repos
| Repo | Stars | Last commit | Licence | Downloads for |
|---|---|---|---|---|
| patrickfreyer / apple-mail-mcp | 250 | 6 days ago | MIT | No downloads |
| s-morgan-jeffries / apple-mail-fast-mcp | 105 | 2 months ago | MIT | No downloads |
| carterlasalle / mac_messages_mcp | 344 | 5 days ago | MIT | No downloads |
More: languages, topics and project record
Languages
- TypeScript 52%
- JavaScript 46%
- Swift 1%
- Objective-C 1%
Topics
- ai
- apple-notes
- applescript
- claude
- macos
- mcp
- model-context-protocol
- apple
- notes
- codex
- apple-shortcuts
Project record
- JobMCP servers
- StatusListed
- Commits423
- Forks28
- Watching1
- Stars in 28 days+30
- CreatedDec 27, 2025
- First seen by usNov 7, 2026
- CheckedNov 10, 2026