buttondown-mcp

Overview

This is a comprehensive TypeScript integration for the Buttondown newsletter service that provides multiple interfaces including a CLI, MCP server, and programmatic API. The MCP server exposes tools for managing email drafts, scheduling emails, retrieving analytics, and managing lists and tags. It offers robust security features including 1Password integration and environment variable support. The project is well-structured with clear separation of concerns between the API client, CLI implementation, and MCP server components.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_emails{status?: string}

  List all emails with optional status filtering

  Try:Show me all my draft emailsTry:List my scheduled emailsTry:Show all sent emails
• create_draft{content: string, title?: string}

  Create a new email draft

  Try:Create a new draft with newsletter contentTry:Draft an email about company updatesTry:Write a draft email with this content: ...
• get_analytics{draftId: string}

  Get analytics for a specific email

  Try:Show analytics for email ID abc123Try:Get performance metrics for my latest emailTry:What are the open rates for draft xyz?
• schedule_draft{draftId: string, scheduledTime: string}

  Schedule an email for sending

  Try:Schedule email draft abc123 for next Monday at 9amTry:Set draft xyz to send on March 27thTry:Schedule this email to go out tomorrow morning

Comparable tools

Installation

# Install using pnpm (recommended)
pnpm install

# Or using npm
npm install

# Or using yarn
yarn install

# Start the MCP server
pnpm mcp:start

{
  "mcpServers": {
    "buttondown": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "BUTTONDOWN_API_KEY": "your_api_key"
      }
    }
  }
}

FAQ

What MCP tools are available?

The server provides `list_emails`, `create_draft`, `get_analytics`, and `schedule_draft` tools for managing Buttondown newsletters.

How is authentication handled?

Authentication can be done via environment variable (BUTTONDOWN_API_KEY) or through 1Password integration for enhanced security.

Compare buttondown-mcp with