Beehiiv

by danvega

Not rated
GitHub

About

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

Details

Author
danvega
Categories
Communication, Marketing, Automation, Other

Setup

Install Beehiiv in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/danvega/beehiiv-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

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

Perfect for most users- Single file download, no installation required!
- Go toBeehiiv API Settings
- Copy yourAPI Key(starts withbh-)
- Copy yourPublication ID(starts withpub_)

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

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

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

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 pathto your downloaded binary file.

Success: You should see Claude use thebeehiiv_create_subscriptiontool!

For developers who want to build from source

- Java 21+(Download here)
- Maven(included via./mvnw)

git clone <this-repo> cd beehiiv-mcp-server ./mvnw clean package -DskipTests
{ "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" } } } }

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.

- Java 21+with GraalVM (Download GraalVM)
- Maven(included via./mvnw)

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

This creates platform-specific binaries intarget/:

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

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" } } } }

- 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

- Java 21+(Download here)
- Maven(included via./mvnw)
- Beehiiv accountwith API access
- Claude Desktop(
Download here)

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

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

Add john.doe@company.com to my newsletter
Create a subscription for sarah@startup.com with custom fields: name "Sarah Johnson", role "CEO", company "TechStart"
Show me my last 10 newsletter posts with their titles and publish dates
Add marketing@bigcorp.com with UTM source "website", medium "signup", campaign "q4-growth"

Don't setBEEHIIV_PUBLICATION_IDto work with multiple newsletters:

{ "env": { "BEEHIIV_API": "bh-your-api-key-here" } }

Then specify the publication in your requests:

Add user@example.com to publication pub_specific123

For testing or development, you can run as a web server:

java -jar target/beehiiv-mcp-server-0.0.2-SNAPSHOT.jar

Then use:"httpUrl": "http://localhost:8080/mcp"in Claude Desktop config.

"Tool not found" in Claude Desktop

- Check the JAR path is correct and absolute - Verify environment variables are set - Restart Claude Desktop completely - Check Claude Desktop's logs/console for errors - Verify your API key starts withbh- - Check it's copied completely (no extra spaces) - Ensure your Beehiiv account has API access enabled - Verify your Publication ID starts withpub_ - Check you have access to this publication - Try withoutBEEHIIV_PUBLICATION_IDand specify it per request

Set environment variable:LOGGING_LEVEL_ROOT=DEBUG

# Test the server directly curl -X POST http://localhost:8080/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc": "2.0", "id": "1", "method": "tools/list"}'

For detailed Beehiiv API documentation:developers.beehiiv.com
- Fork the repository
- Create a feature branch
- Add tests for new functionality
- Submit a pull request

- Issues:GitHub Issues
- Beehiiv API:
Official Documentation
- MCP Protocol:
Model Context Protocol

Integrate with the Brevo email marketing platform via its API.

Manage email marketing campaigns, contacts, and transactional emails with the Cakemail API.

Generates professional LinkedIn post drafts from YouTube videos by summarizing their content.

Threads tools for AI agents — generate viral posts, download videos, and export profile data from Meta Threads.

A read-only MCP server by CData that enables LLMs to query live SendGrid data. Requires the external CData JDBC Driver for SendGrid.

The Elastic Email MCP Server enables AI agents like GitHub Copilot, ChatGPT, Claude, and other compatible assistants to seamlessly integrate with your Elastic Email account.

Instagram Graph API server for Business/Creator accounts — 24 tools for posting, comments, DMs, and insights.

Allow your agents to launch personalized outbound campaigns

Your AI agent just got a marketing team. SendPulse MCP Server provides full access to the SendPulse marketing platform — email campaigns, CRM, chatbots, SMTP, and online courses. 134 methods across 5 modules.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.