Drafts MCP Server

Official MCP server for the Drafts macOS app. Lets AI assistants create, read, update, search, tag, and run actions on drafts via AppleScript.

Collaboration by Agile Tortoise None active

GitHub Docs npm: @agiletortoise/drafts-mcp-server

Overview

The Drafts MCP server is the official integration from Agile Tortoise (the maker of Drafts) that lets AI assistants like Claude interact with the Drafts macOS app over the Model Context Protocol. It bridges to Drafts locally through AppleScript, so all data stays on the user's machine and no API keys or cloud sync are required.

The server exposes tools for the full draft lifecycle: creating drafts with tags and flag status, retrieving drafts by UUID or filters (folder, tag, date, flagged), updating content, full-text search, and status changes like flag, archive, and trash. It also covers organizational features such as listing workspaces, adding tags, and listing or running Drafts actions, which means AI clients can trigger any automation already configured inside Drafts.

The package ships as both an MCP server and a standalone CLI, distributed via npm and as a one-click .mcpb extension for Claude Desktop. It requires macOS, Drafts v50.0.3 or later, Node.js 18+, and the user must grant Automation permission to the AI client the first time it is used.

Tools

Tool	Description
`drafts_list_workspaces`	List all workspaces configured in Drafts.
`drafts_get_drafts`	Retrieve drafts with optional filters for folder, tag, flagged status, and dates.
`drafts_create_draft`	Create a new draft with optional tags and flagged status.
`drafts_get_draft`	Fetch a specific draft by its UUID.
`drafts_update_draft`	Update the content of an existing draft.
`drafts_search`	Full-text search across drafts.
`drafts_add_tags`	Add one or more tags to a draft.
`drafts_list_actions`	List available Drafts actions that can be executed.
`drafts_run_action`	Execute a named Drafts action against a specific draft.
`drafts_flag`	Flag or unflag a draft.
`drafts_archive`	Move a draft to the archive folder.
`drafts_trash`	Move a draft to the trash.

Setup Guide

Prerequisites

macOS (the server uses AppleScript and will not work on Linux or Windows)
Drafts app v50.0.3 or later, installed and running
Node.js 18+
On first run, grant Automation permission to your AI client under System Settings, Privacy and Security, Automation

Install

Run directly with npx, or install globally:

npx @agiletortoise/drafts-mcp-server
# or
npm install -g @agiletortoise/drafts-mcp-server

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "drafts": {
      "command": "npx",
      "args": ["@agiletortoise/drafts-mcp-server"]
    }
  }
}

A prebuilt .mcpb file is also available: drag it into Claude Desktop, Settings, Extensions.

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "drafts": {
      "command": "npx",
      "args": ["@agiletortoise/drafts-mcp-server"]
    }
  }
}

Claude Code

claude mcp add drafts -- npx @agiletortoise/drafts-mcp-server

Local development

git clone https://github.com/agiletortoise/drafts-mcp-server.git
cd drafts-mcp-server
npm install
npm run build
npm run inspector

Use Cases

Capture meeting notes or ideas into Drafts directly from a Claude conversation, tagged and flagged as needed
Search a personal Drafts library for past notes by keyword and summarize or rewrite the results
Triage the inbox by listing recent drafts and automatically archiving, flagging, or trashing them based on content
Trigger existing Drafts actions (publish to a blog, send to a task manager, run a script) on AI-selected drafts
Bulk-tag or reorganize drafts across workspaces using natural-language filters

Example Prompts

"Create a new draft titled 'Q3 planning notes' tagged with 'work' and 'planning', and flag it."
"Search my drafts for anything mentioning 'API redesign' and summarize the top 3 results."
"List all flagged drafts in the inbox from the last 7 days and archive the ones older than 3 days."
"Run the 'Send to Things' action on the draft with the title 'Tomorrow's tasks'."
"Show me every workspace I have and how many drafts are flagged in each."

Pros

Official server from Agile Tortoise, the maker of Drafts, so it tracks the app closely
Comprehensive coverage of the Drafts data model: drafts, tags, workspaces, actions, and status changes
Runs entirely locally through AppleScript, no cloud round-trip and no API key required
Ships as both an MCP server and a CLI, and is available as a one-click .mcpb install for Claude Desktop

Limitations

macOS only, no support for Linux, Windows, or iOS / iPadOS
Requires Drafts to be installed, running, and granted Automation permission
Action execution depends on actions already configured inside the Drafts app, the server cannot create new actions

Alternatives

Automaat/drafts-mcp, a community MCP server for Drafts
dropte/draftsapp-mcp, a community server using the Drafts x-callback-url scheme
macuse-mcp, a broader Mac automation MCP that controls Notes, Reminders, and other apps