How do I install Beehiiv?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Beehiiv need an API key?

No required environment variable is listed on this record.

When was Beehiiv last checked?

Last checked 2026-10-22. Manage beehiiv newsletters, posts, podcasts, community, subscribers, and analytics.

Beehiiv MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://mcp.beehiiv.com/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http com.beehiiv-beehiiv https://mcp.beehiiv.com/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.beehiiv-beehiiv": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://mcp.beehiiv.com/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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:

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

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Beehiiv?

Does Beehiiv need an API key?

What transport does Beehiiv use?

When was Beehiiv last checked?

Documentation

beehiiv/agents

What you can do

Skills

Install

Claude

ChatGPT

Claude Code and Cursor

Grok Build

Gemini CLI

Codex

Any other MCP client

Authentication

Requirements

Layout

Network endpoints and credentials

Validate

Licence