Beehiiv
About
Manage your Beehiiv newsletter by adding subscribers and fetching posts using natural language.
Details
- Author
- danvega
- Categories
- Communication, Marketing, Automation, Other
Jump to
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.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


