Beehiiv MCP Server

What is Beehiiv MCP Server?

An MCP server that provides tools for interacting with the Beehiiv API v2. It enables LLMs (via MCP-compatible clients like Claude Desktop) to list publications, manage posts, and perform other Beehiiv actions through standardized tools.

How to use Beehiiv MCP Server?

Install prerequisites (Python 3.10+, uv), create a project with dependencies (mcp[cli], httpx, python-dotenv), configure a .env file with BEEHIIV_API_KEY and BEEHIIV_PUBLICATION_ID, then add the server to your MCP client's configuration (e.g., claude_desktop_config.json) with the absolute paths to uv and beehiiv_server.py. After starting the client, use natural language prompts to invoke the available tools.

Key features of Beehiiv MCP Server

• Lists publications accessible with your API key
• Lists the 5 most recent confirmed posts for a publication
• Retrieves detailed information about a specific post
• Retrieves full HTML content for a post
• Creates new posts (enterprise only)

Use cases of Beehiiv MCP Server

• Querying recent posts and their details via a conversational interface
• Drafting and publishing new posts (enterprise accounts) through natural language
• Automating newsletter content retrieval and scheduling from an LLM
• Integrating Beehiiv data into AI workflows for analysis or summarization

FAQ from Beehiiv MCP Server

What does Beehiiv MCP Server do?

It gives LLMs the ability to interact with Beehiiv publications and posts using standardized MCP tools.

What are the prerequisites to run it?

Python 3.10 or higher, the uv package manager, a Beehiiv account with API access, and an MCP-compatible client (e.g., Claude Desktop).

Which tools are available?

Currently: list_publications, list_posts, get_post, get_post_content, and create_new_post. More may be added.

Is create_new_post available to all users?

No, it is listed as “enterprise only.”

How is authentication handled?

You must create a .env file with your BEEHIIV_API_KEY and BEEHIIV_PUBLICATION_ID. The README warns never to commit this file to version control.