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