Beehiiv MCP Server

Connect your Beehiiv newsletter to Claude Desktop and other AI assistants. Add subscribers, fetch posts, and manage publications using natural

Local serverstdioGo

What is the Beehiiv MCP server?

If you already use Beehiiv, the beehiiv mcp server is the piece that lets your assistant work with it directly. Connect your Beehiiv newsletter to Claude Desktop and other AI assistants. Add subscribers, fetch posts, and manage publications using natural language.

Installation

Setup follows the usual MCP pattern — install or clone the server, register it in your client's configuration file, restart the client. The configuration blocks on this page cover the common clients.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Prerequisites — The Prerequisites tool exposed by this server
  • Steps — Then configure Claude Desktop with: json { "mcpServers": { "beehiiv": { "command": "java", "args": [ "-jar"
  • Benefits — The Benefits tool exposed by this server

Credentials and setup notes

Configuration is passed through the environment: BEEHIIV_API, BEEHIIV_PUBLICATION_ID. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

Plenty of developer tooling servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. Beehiiv's toolset — Prerequisites, Steps, Benefits — is a fair guide to whether it matches your workflow. It is maintained by danvega; worth a glance at recent repository activity before you build anything load-bearing on it.

We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.

Available tools

ToolWhat it does
PrerequisitesThe Prerequisites tool exposed by this server.
StepsThen configure Claude Desktop with: json { "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",
BenefitsThe Benefits tool exposed by this server.

How to install the Beehiiv MCP server

Then configure Claude Desktop with:
```json
{
  "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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

VariableDescriptionRequired
BEEHIIV_APIConfiguration value read at startup.Optional
BEEHIIV_PUBLICATION_IDConfiguration value read at startup.Optional

Example prompts to try

  • Use Beehiiv to Prerequisites.
  • Use Beehiiv to Steps.
  • Use Beehiiv to Benefits.

Frequently asked questions

It connects Beehiiv to MCP-compatible AI assistants such as Claude and Cursor, exposing 3 tools (Prerequisites, Steps, Benefits) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Beehiiv directly.