beehiiv MCP server
Commit Nov 2, 2026Manage beehiiv newsletters, posts, podcasts, communities, subscribers, and analytics through an AI agent.
Also known as beehiiv/agents, agents
- Stars
- 1
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 0.1.0
- Last commit
- Nov 2, 2026
- License
- MIT
What is beehiiv MCP?
beehiiv manages beehiiv newsletters, posts, podcasts, communities, subscribers, and analytics through an AI agent.
Summary generated from the project's README
About beehiiv MCP server
Managing newsletter content, subscriber segments, and publication analytics through an AI agent is what this server enables for beehiiv publishers. It connects directly to your beehiiv workspace to handle tasks like drafting posts, managing community channels, uploading podcast episodes, and building automation journeys. Because the server is hosted at a remote endpoint, nothing runs on your local machine, making it easy to integrate with various clients.
Developers and creators can use this with Claude Code, Cursor, Grok Build, Gemini CLI, and Codex. Authentication uses OAuth 2.1, so you sign in via a browser rather than managing manual API keys. The agent operates within your existing permission levels, meaning it can only access the publications you already manage. While the agent can prepare posts, templates, and automation steps, publishing and sending remain manual human actions to ensure you maintain final control over your content.
What you can do with it
- 1Drafting and editing newsletter contentAsk your AI agent to prepare a new post or duplicate an existing template for your newsletter.
- 2Managing community engagementInstruct the agent to create new channels, manage member roles, or send direct messages within your community.
- 3Analyzing publication performanceRequest detailed reports on earnings, subscriber engagement, or website analytics to track growth.
- 4Automating subscriber journeysHave the agent build automation steps, triggers, and email variants for your audience.
Written from the project's README. Every use case is checked against a quote from it.
How to install beehiiv MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall beehiiv MCP in Claude Code
$ claude mcp add --transport http agents https://mcp.beehiiv.com/mcpInstall beehiiv MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agents": {
"url": "https://mcp.beehiiv.com/mcp"
}
}
}Install beehiiv MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agents": {
"type": "http",
"url": "https://mcp.beehiiv.com/mcp"
}
}
}Install beehiiv MCP in VS Code CLI
$ code --add-mcp '{"name":"agents","type":"http","url":"https://mcp.beehiiv.com/mcp"}'Install beehiiv MCP in Codex
$ codex mcp add agents --url https://mcp.beehiiv.com/mcpInstall beehiiv MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agents] url = "https://mcp.beehiiv.com/mcp"
Install beehiiv MCP in Gemini CLI
$ gemini mcp add -s user --transport http agents https://mcp.beehiiv.com/mcpInstall beehiiv MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agents": {
"url": "https://mcp.beehiiv.com/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablebeehiiv/agents is public and reachablegithub.com/beehiiv/agents ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-02github.com/beehiiv/agents ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubbeehiiv/agents
Official beehiiv tools for AI agents, built on the beehiiv MCP server.
This repository holds the plugin manifests for Claude Code, Grok Build, Gemini CLI, Cursor and
Codex, plus the official MCP registry entry. They all point at the same hosted server at
https://mcp.beehiiv.com/mcp. Nothing runs on your machine.
What you can do
Once connected, the agent works against your beehiiv workspace directly:
- Posts. Draft, edit and duplicate posts and post templates. Read post content, stats, clicks, comments and per-subscriber engagement. Publishing and sending stay human actions in beehiiv, so the agent prepares the post and you press send.
- Communities. Create channels, publish and pin posts, moderate reports, manage members and roles, send invites and direct messages, read community metrics.
- Podcasts. Create shows and episodes, upload audio, schedule episodes, read transcripts and episode stats.
- Automations. Build journeys, steps, triggers and automation emails, including A/B variants. Activating an automation stays a human action in the editor.
- Audience. Manage subscriptions, segments, tags, custom fields, newsletter lists and signup flows.
- Monetisation. Products, tiers, premium offers, orders, paywalls, the ad network and the sponsor network.
- Growth. Recommendations, referral programs, polls and surveys.
- Analytics. Publication and website analytics, post and podcast stats, poll and survey responses, earnings.
The server also documents itself. Ask the agent to call search_documentation,
read_documentation, or any of the learn_* tools, and it fetches current guidance on post
authoring and community authoring rather than guessing.
Skills
The plugin also ships skills for the jobs publishers ask for most: getting started and setting up a new publication, performance and revenue reports, unsubscribe spikes, automation drop-off, media kits, segments, post edits and upgrade campaigns. See plugins/beehiiv/README.md for the full list. Clients that support Agent Skills load them with the plugin; the others get the MCP server alone.
Install
Claude
beehiiv is in the Claude connector directory. Add it from the beehiiv connector page, then sign in when prompted.
ChatGPT
beehiiv is in the shared ChatGPT and Codex plugin directory. Add it from the beehiiv plugin page.
Claude Code and Cursor
/plugin marketplace add beehiiv/agents
/plugin install beehiiv@beehiiv
Grok Build
grok plugin install beehiiv/agents
Gemini CLI
gemini extensions install https://github.com/beehiiv/agents
Codex
Run /plugins, select beehiiv, then choose Install Plugin. Codex and ChatGPT share
one plugin directory, so installing in either place covers both.
Or add the server to ~/.codex/config.toml by hand:
[mcp_servers.beehiiv]
url = "https://mcp.beehiiv.com/mcp"
enabled = true
Cloning this repo and trusting it also works. .codex/config.toml registers the server for
sessions inside the repo.
Any other MCP client
Point it at https://mcp.beehiiv.com/mcp over Streamable HTTP. Setup snippets are in your beehiiv
workspace under Settings → Workspace → MCP.
Authentication
OAuth 2.1. There is no API key to copy and no secret to store in this repo.
On first use your client registers itself automatically (RFC 7591 dynamic client registration) and
opens a browser to beehiiv, where you sign in and grant access. The client receives an access token
and a refresh token scoped to read and write.
Every tool call is authorised against your own beehiiv permissions. The agent can only reach publications you can already reach.
Requirements
- A beehiiv account on a plan that includes MCP access.
- MCP enabled for your workspace. Check Settings → Workspace → MCP.
If MCP is off for your workspace, tool calls return a permission error. See Getting started with the beehiiv MCP for the current plan requirements.
Some tool groups are gated separately, so the tools an agent sees depend on your plan and workspace settings.
Layout
.mcp.json lives at plugins/beehiiv/ and states the server URL once.
Every ecosystem manifest beside it delegates to that file.
.claude-plugin/marketplace.json point their client at ./plugins/beehiiv
.cursor-plugin/marketplace.json
.grok-plugin/marketplace.json
plugins/beehiiv/.mcp.json the shared server config
plugins/beehiiv/.claude-plugin/ per-ecosystem plugin manifests
plugins/beehiiv/.cursor-plugin/
plugins/beehiiv/.grok-plugin/
plugins/beehiiv/.codex-plugin/
gemini-extension.json must sit at the repo root
server.json official MCP registry entry
Gemini requires its manifest at the absolute repo root and does not support delegating to a shared file, so the server URL appears there a second time.
Network endpoints and credentials
Declared for review and for anyone auditing what this plugin reaches:
| Endpoint | Purpose |
|---|---|
https://mcp.beehiiv.com/mcp |
The MCP server. All tool calls. |
https://mcp.beehiiv.com/.well-known/oauth-protected-resource |
OAuth resource discovery (RFC 9728). |
https://mcp.beehiiv.com/.well-known/oauth-authorization-server |
OAuth server metadata (RFC 8414). |
https://mcp.beehiiv.com/register |
Dynamic client registration (RFC 7591). |
https://mcp.beehiiv.com/authorize |
Starts the sign-in flow. Redirects to app.beehiiv.com. |
https://mcp.beehiiv.com/token |
Token exchange and refresh. |
Credentials required: a beehiiv account. The plugin requests the read and write scopes.
This repository ships no executable code beyond scripts/validate.sh, no install hooks and no
local processes. The plugins are JSON manifests pointing at a hosted HTTPS endpoint.
Validate
./scripts/validate.sh
Licence
MIT. See LICENSE.
beehiiv MCP questions
How do I add beehiiv MCP to Claude Code?
Run claude mcp add --transport http agents https://mcp.beehiiv.com/mcp in your terminal. Add --scope user to make it available in every project.
How do I add beehiiv MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Can the AI agent publish my posts automatically?
No, publishing and sending remain human actions in beehiiv; the agent prepares the post for you to review and send.
How does authentication work with this server?
The server uses OAuth 2.1. On first use, the client automatically registers and opens a browser for you to sign in and grant access.
What are the requirements to use the beehiiv MCP?
You need a beehiiv account on a plan that includes MCP access and must have MCP enabled for your workspace.
Does the agent have access to all my publications?
The agent is limited by your existing permissions and can only reach publications that you can already reach.