# Buttondown MCP Server

An MCP (Model Context Protocol) server for interacting with the [Buttondown](https://buttondown.com) 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

```bash
claude mcp add buttondown -- npx -y buttondown-mcp
```

Then set your API key:

```bash
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:

```json
{
  "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