Beehiiv MCP Server

🚀 Beehiiv MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with the Beehiiv API v2. This server allows Large Language Models (LLMs) to interact with Beehiiv publications and posts through standardized tools.

🚀 Quick Start

✨ Features

This MCP server enables Large Language Models (LLMs) to interact with Beehiiv publications and posts in a standardized way, providing multiple useful tools for operations such as listing publications and posts, getting post details, and creating new posts.

📦 Installation

Prerequisites

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

Installation Steps

1. Install uv if it's not already installed:

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

2. If you're building the project from scratch, do the following to create and set up the project:

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

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

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

3. Create a .env file in the project root directory:

BEEHIIV_API_KEY=your_api_key_here
BEEHIIV_PUBLICATION_ID=your_publication_id_here

💻 Usage Examples

Claude Desktop Configuration

Add the following to the Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):

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

Replace:

• <ABSOLUTE_UV_PATH> with the absolute path to your uv executable
• <ABSOLUTE_SERVER_PATH> with the absolute path to your beehiiv_server.py file

Available Tools

Currently, this MCP server exposes the following tools (more features are coming soon):

Basic Usage

• list_publications: Lists all publications accessible with your API key.
• list_posts: Lists the 5 latest confirmed posts of a specified publication.

list_posts(publication_id: str)

• get_post: Retrieves detailed information about a specific post.

get_post(publication_id: str, post_id: str)

Advanced Usage

• get_post_content: Retrieves the full HTML content of a post.
• create_new_post: Creates a new post on the Beehiiv platform (for enterprise users only).

📚 Documentation

How It Works

When you interact with this server through Claude Desktop:

1. The client sends your question to Claude.
2. Claude analyzes the available Beehiiv tools and decides which ones to use.
3. The client executes the selected tools through this MCP server.
4. The results are returned to Claude.
5. Claude forms a natural language response.
6. The response is displayed to you.

(Video coming soon)

🔧 Technical Details

Troubleshooting

Server Not Showing in Claude

1. Check the syntax of your claude_desktop_config.json file.
2. Ensure all paths are absolute, not relative.
3. Restart Claude Desktop.

Viewing Logs

Check the MCP-related problem logs in Claude:

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

Logs are stored in the following locations:

• ~/Library/Logs/Claude/mcp.log for general MCP connection logs
• ~/Library/Logs/Claude/mcp-server-beehiiv-mcp-server.log for server-specific logs

📄 License

No license information provided in the original document.

⚠️ Important Note

• Never expose sensitive information such as API keys in the .env file.
• Ensure the server runs in a secure network environment.
• Regularly update dependencies to prevent potential security vulnerabilities.

💡 Usage Tip

If you want to contribute or report issues, please contact: [Your contact information]