Beehiiv

Provides tools to interact with Beehiiv publications and posts via MCP, enabling LLMs to query and manage Beehiiv content.

python

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "reymerekar7-beehiiv-mcp-server": {
      "command": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ],
      "env": {
        "BEEHIIV_API_KEY": "YOUR_API_KEY",
        "BEEHIIV_PUBLICATION_ID": "YOUR_PUBLICATION_ID"
      }
    }
  }
}

This MCP server enables Large Language Models to interact with Beehiiv API v2 by exposing a standardized set of tools for working with Beehiiv publications and posts. You can run it locally and connect from an MCP client to perform common actions via natural language prompts.

How to use

You will run the MCP server locally and connect it from your MCP client (such as Claude Desktop). The server exposes tools you can invoke to list publications, retrieve posts, read post content, and create new posts (enterprise only). Use these tools by asking your MCP client to perform a task, and the client will delegate the work to the server which in turn talks to Beehiiv on your behalf.

How to install

Prerequisites you need before installation:

Python 3.10 or higher
uv package manager
A Beehiiv account with API access
Claude Desktop (or another MCP-compatible client)

Install steps

curl -LsSf https://astral.sh/uv/install.sh | sh

# Create a new directory and navigate into it
mkdir beehiiv-mcp-server
cd beehiiv-mcp-server

# Create virtual environment and activate it
uv venv
source .venv/bin/activate

# Install dependencies
uv add "mcp[cli]" httpx python-dotenv

# Create a .env file in the project root
BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

Claude Desktop configuration (for launching the MCP server) requires a JSON config snippet that points to the uv runtime and the server script. Use this configuration as a starting point in your Claude Desktop setup.

{
  "mcpServers": {
    "beehiiv-mcp-server": {
      "command": "<ABSOLUTE_UV_PATH>",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "<ABSOLUTE_SERVER_PATH>"
      ]
    }
  }
}

Notes on configuration and environment

Environment variables shown in the configuration are required to run the server. Provide your actual values in a secure manner and do not commit the .env file to version control.

Troubleshooting

Server Not Showing Up in Claude

Check your claude_desktop_config.json file syntax
Ensure all paths are absolute, not relative
Restart Claude Desktop

Viewing Logs Check Claude's logs for MCP-related issues: tail -n 20 -f ~/Library/Logs/Claude/mcp*.logLogs are stored in: -~/Library/Logs/Claude/mcp.logfor general MCP connections - ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log for server-specific logs

Available tools

list_publications

Lists all Beehiiv publications that your API key can access.

list_posts

Retrieves the 5 most recent confirmed posts for a specified publication.

get_post

Fetches detailed information about a single post, including metadata.

get_post_content

Returns the full HTML content for a specified post.

create_new_post

Creates a new post on Beehiiv (enterprise only) and returns the new post details.

Built by

VeilStrat

AI signals for GTM teams