Buttondown MCP Server

An MCP (Model Context Protocol) server for interacting with the Buttondown newsletter API.

Tools

Emails

Tool	Description
list_emails	List emails with optional status filter (draft/scheduled/sent)
get_email	Get single email details by ID
create_draft	Create new draft with markdown content
update_draft	Edit existing draft
send_draft	Send a draft immediately
schedule_draft	Schedule a draft for later
get_analytics	Get open/click rates for sent emails

Subscribers

Tool	Description
list_subscribers	List subscribers with optional type filter (regular/premium/churned/etc.)
get_subscriber	Get subscriber details by ID or email address

Tags

Tool	Description
list_tags	List all tags in your newsletter
get_tag	Get tag details by ID
create_tag	Create a new tag with optional color and description
update_tag	Update an existing tag
delete_tag	Delete a tag (subscribers remain unaffected)

Installation

Claude Code

claude mcp add buttondown -- npx -y buttondown-mcp

Then set your API key:

claude mcp add-json buttondown '{"command":"npx","args":["-y","buttondown-mcp"],"env":{"BUTTONDOWN_API_KEY":"your-api-key"}}'

Manual Configuration

Add to your Claude Code settings:

{
  "mcpServers": {
    "buttondown": {
      "command": "npx",
      "args": ["-y", "buttondown-mcp"],
      "env": {
        "BUTTONDOWN_API_KEY": "your-api-key"
      }
    }
  }
}

Get your API key from https://buttondown.com/settings/api

License

MIT