Skip the install. Get this working in under 2 minutes.
Start a free trial on cloud.anythingmcp.com, add the beehiiv in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.
Summary
Drive beehiiv (modern newsletter platform) from any AI agent: publications, posts, subscriptions, segments, custom fields. 11 tools, Bearer auth.
Try asking
Example prompts for beehiiv
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → beehiiv, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
beehiiv + Gemini
Drive beehiiv (modern newsletter platform) from any AI agent: publications, posts, subscriptions, segments, custom fields. 11 tools, Bearer auth.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
BEEHIIV_API_KEY, BEEHIIV_PUBLICATION_ID
Step 1 — Get credentials
beehiiv.com).
Setup:
- Sign in to https://app.beehiiv.com → bottom-left avatar → Settings → Integrations → API → Generate New API key.
- Set the key to
BEEHIIV_API_KEY. - Note your Publication ID — visible in the URL when you're on a publication's dashboard (
/p/pub_XXX/...). SetBEEHIIV_PUBLICATION_ID.
Authentication: Authorization: Bearer ${BEEHIIV_API_KEY}.
Publication-scoped URL: most endpoints live under /publications/{publicationId}/.... The adapter bakes publication ID into baseUrl.
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Get your MCP API key from AnythingMCP → MCP Servers → your server → API keys.
- Save the file and restart
gemini. - Run
/mcpinside the Gemini CLI —beehiivshould be listed as available. - Vertex AI Studio: pass
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDto thetoolsarray of your request with the sameX-API-Keyheader.
Available tools
| Tool | What it does |
|---|---|
beehiiv_get_publication | Get the publication metadata (name, organization_name, referral_program_enabled, created) |
beehiiv_list_posts | List posts (newsletter issues) |
beehiiv_get_post | Fetch a single post with full content |
beehiiv_list_subscriptions | List subscribers with filters |
beehiiv_get_subscription | Fetch a subscriber by ID or email |
beehiiv_create_subscription | Create a subscription (subscribe an email) |
beehiiv_update_subscription | Update a subscriber (custom fields, UTM tags, tier) |
beehiiv_delete_subscription | Permanently delete a subscriber (GDPR friendly) |
beehiiv_list_segments | List segments (saved subscriber queries) |
beehiiv_list_custom_fields | List custom fields defined on subscribers |
beehiiv_send_test_email | Send a test email of a post to specific addresses |
FAQ
Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with custom headers.
Next steps
Was this guide helpful?
