beehiiv — Claude Code MCP server: what it does, how to install
Links your AI agent to your beehiiv workspace to draft newsletters, segment subscribers, and review performance. Built for editors managing publications from the terminal or IDE.
claude mcp add --transport http beehiiv https://mcp.beehiiv.com/mcpWhat beehiiv does
The integration runs against a hosted endpoint at https://mcp.beehiiv.com/mcp. No processes run on your local machine. Agents use Streamable HTTP to generate post drafts, organize subscriber tags, design email sequences, and inspect click rates. Publishing and triggering automations stay manual actions in the web interface, so the agent prepares assets without sending them out automatically.
Authentication relies on OAuth 2.1 instead of manual API keys. On the first tool call, the client registers dynamically and redirects you to a browser login. Permissions match your existing beehiiv credentials, so the model only touches publications you already manage.
If MCP is disabled in workspace settings, all calls fail with a permission error. Tool availability also depends on your beehiiv subscription plan.
What it helps with
- draft newsletter issues and duplicate article templates
- pull engagement metrics and click statistics
- configure subscriber tags, lists, and audience segments
- construct automated email sequences with A/B variants
Example prompts for the agent
- Check subscriber engagement and click counts for the latest issues.
- Draft an announcement newsletter and create an audience segment for paid members.
- Look up authoring guidelines using the
search_documentationtool.
How to install beehiiv
Platform CLI: remote server
claude mcp add --transport http beehiiv https://mcp.beehiiv.com/mcpPlatform CLI: remote server
codex mcp add beehiiv --url https://mcp.beehiiv.com/mcpConfig file
{
"mcpServers": {
"beehiiv": {
"url": "https://mcp.beehiiv.com/mcp"
}
}
}Config file
{
"servers": {
"beehiiv": {
"type": "http",
"url": "https://mcp.beehiiv.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http beehiiv https://mcp.beehiiv.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about beehiiv
How to install beehiiv in Claude Code?
Run claude mcp add --transport http beehiiv https://mcp.beehiiv.com/mcp. The assistant will connect to the hosted HTTP endpoint.
What does the beehiiv MCP server do?
It lets your agent read analytics, structure email drafts, manage subscriber records, and edit automations. Actual publishing remains a manual step inside the beehiiv dashboard.
Is an API key required to connect beehiiv?
No API key is needed. The server authenticates through OAuth 2.1 by launching a browser login during the first run.
