Labsco
danvega logo

Beehiiv

★ 21

from danvega

Manage your Beehiiv newsletter by adding subscribers and fetching posts using natural language.

🔥🔥🔥✓ VerifiedPaid serviceAdvanced setup
#email#git#marketing

Beehiiv MCP Server

🚀 Super Quick Start: Get Beehiiv newsletter management working in Claude Desktop in under 2 minutes - no Java required!

Connect your Beehiiv newsletter to Claude Desktop and other AI assistants. Add subscribers, fetch posts, and manage publications using natural language.

What You Can Do

Once set up, you can ask Claude Desktop things like:

  • "Add test@example.com to my newsletter"
  • "Show me my latest 5 newsletter posts"
  • "Create a subscriber with custom fields: name John, company Tech Corp"
  • "List all my publications"

📦 Native Binary (No Java)

Perfect for most users - Single file download, no installation required!

1. Get Your API Credentials

  1. Go to Beehiiv API Settings
  2. Copy your API Key (starts with bh-)
  3. Copy your Publication ID (starts with pub_)

2. Download Binary

Option A: One-Command Install (Linux/macOS)

curl -fsSL https://raw.githubusercontent.com/danvega/beehiiv-mcp-server/main/scripts/install.sh | bash

Option B: Manual Download

Go to Latest Release and download:

  • Linux: beehiiv-mcp-server-linux
  • macOS: beehiiv-mcp-server-macos
  • Windows: beehiiv-mcp-server-windows.exe

Make executable (Linux/macOS only):

chmod +x beehiiv-mcp-server-*

3. Configure Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "beehiiv": {
      "command": "/full/path/to/beehiiv-mcp-server-linux",
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

⚠️ Use the full path to your downloaded binary file.

4. Test It Works

  1. Restart Claude Desktop
  2. Look for the 🔧 icon in a new conversation
  3. Try: "Add subscriber test@example.com to my newsletter"

✅ Success: You should see Claude use the beehiiv_create_subscription tool!

☕ Java Build (Traditional)

For developers who want to build from source

Prerequisites

Steps

git clone <this-repo>
cd beehiiv-mcp-server
./mvnw clean package -DskipTests

Then configure Claude Desktop with:

{
  "mcpServers": {
    "beehiiv": {
      "command": "java",
      "args": [
        "-jar", 
        "/FULL/PATH/TO/target/beehiiv-mcp-server-0.0.3-SNAPSHOT.jar"
      ],
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

🔥 Native Image Build (Advanced)

For developers who want to create optimized native binaries

Native image compilation creates fast-starting, low-memory executables that don't require Java to run.

Prerequisites

Build Native Image

git clone <this-repo>
cd beehiiv-mcp-server
./mvnw clean package -Pnative -DskipTests

This creates platform-specific binaries in target/:

  • Linux: beehiiv-mcp-server-linux
  • macOS: beehiiv-mcp-server-macos
  • Windows: beehiiv-mcp-server-windows.exe

Configure Claude Desktop

Use the native binary directly without Java:

{
  "mcpServers": {
    "beehiiv": {
      "command": "/full/path/to/beehiiv-mcp-server-linux",
      "env": {
        "BEEHIIV_API": "bh-your-api-key-here",
        "BEEHIIV_PUBLICATION_ID": "pub-your-publication-id-here"
      }
    }
  }
}

Benefits

  • Fast startup: ~50ms vs ~2s for Java
  • Low memory: ~20MB vs ~100MB for Java
  • No Java required: Self-contained executable
  • Better for production: Optimized runtime performance

Available Tools

📧 Subscription Management

  • Add subscribers: Create new subscriptions with custom fields
  • Find subscribers: Look up by email or ID
  • Custom fields: Add structured data to subscribers

📝 Content Management

  • Get posts: Fetch your published newsletters
  • Single post: Get detailed content for specific posts
  • Filtering: Search by tags, date, audience type

🏢 Publication Management

  • List publications: See all your newsletters
  • Publication details: Get stats and settings
  • Multi-publication: Work with multiple newsletters

Development

Run Tests

./mvnw test

Build from Source

./mvnw clean package

Project Structure

src/main/java/dev/danvega/beehiiv/
├── Application.java              # Main Spring Boot app
├── core/                        # Configuration & utilities
├── post/                        # Newsletter post management
├── publication/                 # Publication management  
└── subscription/                # Subscriber management

API Reference

For detailed Beehiiv API documentation: developers.beehiiv.com

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Add tests for new functionality
  4. Submit a pull request

Support