Drafts MCP Server
Lets Claude (and other AI assistants) talk to the Drafts app on your Mac. Create drafts, search and read your notes, append or prepend text, and run Drafts actions — all by chatting.
Power your agent
Install from the publisher. Not a PlugMCP endpoint.
Host a copy with our keys and logs.
No packaged release in the registry yet. Follow the repository README.
Remote URL or a command on your machine? How the two installs differ
Run on PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
LaunchFrom the publisher
Lets Claude (and other AI assistants) talk to the Drafts app on your Mac. Create drafts, search and read your notes, append or prepend text, and run Drafts actions — all by chatting.
MCP server for Drafts app integration
Works with: Claude Desktop, Claude Code, Codex CLI, Cursor, Windsurf, VS Code. Needs: the Drafts app on macOS. Nothing else — no programming required.
This is the recommended path. Takes ~2 minutes, no terminal needed.
Go to the latest release page and download the file ending in .mcpb (it's near the top, called drafts-mcp-<version>.mcpb).
Claude Desktop opens automatically and asks: "Install Drafts extension?". Click Install, then enable it.
Don't have Claude Desktop yet? Get it free from claude.com/download.
Open Claude Desktop and type:
Create a draft titled "Shopping list" with milk, eggs, and bread.
Some other things to try:
Note: for write actions (create / append / prepend / open / run action) the Drafts app must be running — they go through Drafts' URL scheme. Reading and searching work straight from the local database, even if Drafts is closed.
Already using Claude Code, Codex, Cursor, Windsurf, or VS Code? Pick your tool below. All paths need Node.js 18+ (except the standalone-binary option at the bottom).
Same .mcpb file as Claude Desktop above — Claude Code accepts it too. Or install via the CLI:
claude mcp add drafts -- npx -y @mskalski/drafts-mcp
codex mcp add drafts -- npx -y @mskalski/drafts-mcp
Open your client's MCP settings and add:
{
"mcpServers": {
"drafts": {
"command": "npx",
"args": ["-y", "@mskalski/drafts-mcp"]
}
}
}
Download the right file from the latest release:
drafts-mcp-darwin-arm64drafts-mcp-darwin-x64Make it runnable and bypass Gatekeeper (the binary isn't signed):
chmod +x ~/Downloads/drafts-mcp-darwin-arm64
xattr -d com.apple.quarantine ~/Downloads/drafts-mcp-darwin-arm64
Point your AI tool at the binary's full path. Example for Codex:
codex mcp add drafts -- /Users/you/Downloads/drafts-mcp-darwin-arm64
git clone https://github.com/Automaat/drafts-mcp.git
cd drafts-mcp
npm install
npm run build
Then point your client at the built entry point:
{
"mcpServers": {
"drafts": {
"command": "node",
"args": ["/absolute/path/to/drafts-mcp/build/index.js"]
}
}
}
~/Library/Group Containers/GTFQ98J4YG.com.agiletortoise.Drafts/.draft://uuid/{uuid} — retrieve a specific draft's content.┌─────────────┐ stdio ┌──────────────────┐ reads ┌────────────────────┐
│ AI client │ ◄────────► │ MCP server │ ─────────► │ DraftStore.sqlite │
│ (Claude/ │ │ (Node, stdio) │ │ (local database) │
│ Codex/...) │ └──────────────────┘ └────────────────────┘
└─────────────┘ │ writes via x-callback-url
▼
┌──────────────────┐
│ Drafts app │
└──────────────────┘
get_*, search_drafts_db) query the local Drafts SQLite database in-process (node:sqlite, or bun:sqlite in the standalone binary) over a persistent read-only connection — works even when Drafts is closed. Falls back to the system sqlite3 CLI on older Node.create, append, prepend, open, run_action, search_drafts) hand a drafts://x-callback-url to the macOS open command fire-and-forget — no x-success/x-error/x-cancel callbacks and no localhost server, so Drafts opens nothing. create_draft reads the new draft's UUID back from the local database. Each write retries 3× with a fixed delay.drafts-mcp [stdio] Run the MCP server over stdio (default)
drafts-mcp --help Show help
drafts-mcp --version Print version
Everything runs locally on your Mac:
drafts://x-callback-url to the macOS open command fire-and-forget. There is no callback server and no open network port; nothing listens for a response.open for URL schemes and reads the macOS Drafts group container.sqlite3 CLI, which must be on PATH.mise install # tools (node, bun)
mise run install # npm install
mise run build # tsc
mise run test # jest
mise run check # lint + format + test + version check
mise run mcpb # build the .mcpb bundle
mise run binary # build standalone macOS binaries via Bun
Repo layout:
src/ — TypeScript MCP server (ESM, Node16).mcpb/manifest.json — .mcpb bundle manifest.scripts/build-mcpb.mjs — pack the .mcpb.scripts/build-binary.mjs — Bun --compile per-target binaries.scripts/bump-version.mjs — single source of truth for the release version.Run the Release workflow (.github/workflows/release.yml) via Actions → Release → Run workflow. It bumps every version source, tags, builds the .mcpb + binaries + npm tarball, publishes to npm (OIDC trusted publishing), and creates the GitHub release.
A tool lives in three hand-kept places in src/index.ts plus its implementation — keep them in sync:
zod schema for the arguments.inputSchema) to the ListToolsRequestSchema handler — keep it identical to the zod shape.case to the CallToolRequestSchema switch that parses with the zod schema and calls the implementation.DraftsDatabase (reads) or DraftsClient (writes) — never inline SQLite/URL logic in index.ts.src/__tests__/ (read tools run against a throwaway SQLite DB).~/Library/Group Containers/GTFQ98J4YG.com.agiletortoise.Drafts/DraftStore.sqlite.xattr -d com.apple.quarantine /path/to/drafts-mcp-darwin-arm64, or right-click → Open the first time.MIT
MCP server for Drafts app integration
Tools
No tool list yet. Remote servers get one after the first health check.
FAQ
Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.
No required environment variable is listed on this record.
Drafts runs locally over stdio.
Last checked 2026-10-28. MCP server for Drafts app integration