beehiiv MCP server

beehiiv/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:

clicks, comments and per-subscriber engagement. Publishing and sending stay human actions in beehiiv, so the agent prepares the post and you press send.

• Posts. Draft, edit and duplicate posts and post templates. Read post content, stats,

roles, send invites and direct messages, read community metrics.

• Communities. Create channels, publish and pin posts, moderate reports, manage members and

and episode stats.

• Podcasts. Create shows and episodes, upload audio, schedule episodes, read transcripts

variants. Activating an automation stays a human action in the editor.

• Automations. Build journeys, steps, triggers and automation emails, including A/B

flows.

• Audience. Manage subscriptions, segments, tags, custom fields, newsletter lists and signup

sponsor network.

• Monetisation. Products, tiers, premium offers, orders, paywalls, the ad network and the

responses, earnings.

• Growth. Recommendations, referral programs, polls and surveys.
• Analytics. Publication and website analytics, post and podcast stats, poll and survey

The server also documents itself. Ask the agent to call searchdocumentation, readdocumentation, 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

Shortened. The full README is on GitHub.