100+ integrations are ready to connect to your AI.Connect your first MCP

beehiiv MCP server for your AI

Look up a subscriber by email, tag them and add them to a list or automation, build a segment, draft a post and email yourself a test, then compare opens and clicks across recent issues.

PopMCPbeehiiv

Find ada@northwind.co, tag her vip and add her to the Pro Tips newsletter list

Supported beehiiv tools

Every beehiiv API v2 operation, pinned to the publication you connect, with a new post saved as a draft unless the AI publishes or schedules it.

beehiiv_create_post

Create post.

beehiiv_create_subscription

Create subscription.

beehiiv_get_post

Get post.

beehiiv_get_posts_aggregate_stats

Get aggregate stats.

beehiiv_get_subscription

Get subscription by ID.

beehiiv_get_subscription_by_email

Get subscription by email.

beehiiv_list_posts

List posts.

beehiiv_list_subscriptions

List subscriptions.

beehiiv_send_post_test_email

Send test email.

beehiiv_update_post

Update post.

beehiiv_update_subscription

Update subscription by ID.

beehiiv_update_subscription_by_email

Update subscription by email.

beehiiv_create_segment

Create segment.

beehiiv_list_segment_members

List segment subscribers.

beehiiv_list_segments

List segments.

beehiiv_bulk_update_subscriptions

Update subscriptions.

beehiiv_create_custom_field

Create custom field.

beehiiv_list_custom_fields

List custom fields.

beehiiv_add_newsletter_list_subscription

Create newsletter list subscription.

beehiiv_create_webhook

Create a webhook.

beehiiv_list_newsletter_lists

List newsletter lists.

beehiiv_list_tiers

List tiers.

beehiiv_list_webhooks

List webhooks.

beehiiv_add_subscription_to_automation

Add subscription to an automation.

beehiiv_identify_workspace

Identify workspace.

beehiiv_list_automations

List automations.

beehiiv_list_polls

List polls.

beehiiv_get_publication

Get publication.

beehiiv_list_publications

List publications.

beehiiv_add_subscription_tags

Add subscription tag.

beehiiv_bulk_create_subscriptions

Bulk create subscription.

beehiiv_get_engagements

Get publication engagements.

beehiiv_get_referral_program

Get referral program.

beehiiv_delete_post

Delete post.

beehiiv_delete_subscription

Delete subscription.

beehiiv_get_podcast

Get podcast.

beehiiv_get_podcast_episode

Get podcast episode.

beehiiv_get_podcast_private_feed

Get private feed.

beehiiv_get_podcast_private_feed_by_email

Get private feed by email.

beehiiv_get_post_preview_url

Generate post preview URL.

beehiiv_list_podcast_episodes

List podcast episodes.

beehiiv_list_podcasts

List podcasts.

beehiiv_send_podcast_private_feed_email

Send private feed email.

beehiiv_send_podcast_private_feed_email_by_email

Send private feed email by email.

beehiiv_update_subscription_put

Update subscription by ID.

beehiiv_delete_segment

Delete segment.

beehiiv_get_segment

Get segment.

beehiiv_list_segment_subscriber_ids

List segment subscriber IDs.

beehiiv_recalculate_segment

Recalculate segment.

beehiiv_bulk_update_subscription_status

Update subscriptions' status.

beehiiv_bulk_update_subscription_status_put

Update subscriptions' status.

beehiiv_bulk_update_subscriptions_put

Update subscriptions.

beehiiv_delete_custom_field

Delete custom field.

beehiiv_get_bulk_subscription_update

Get subscription update.

beehiiv_get_custom_field

Get custom field.

beehiiv_list_bulk_subscription_updates

List subscription updates.

beehiiv_update_custom_field

Update custom field.

beehiiv_update_custom_field_put

Update custom field.

beehiiv_create_newsletter_list

Create newsletter list.

beehiiv_create_tier

Create a tier.

beehiiv_delete_newsletter_list

Delete newsletter list.

beehiiv_delete_webhook

Delete a webhook subscription from a publication.

beehiiv_get_newsletter_list

Get newsletter list.

beehiiv_get_newsletter_list_subscription

Get newsletter list subscription.

beehiiv_get_tier

Get tier.

beehiiv_get_webhook

Get webhook.

beehiiv_list_newsletter_list_subscriptions

List newsletter list subscriptions.

beehiiv_update_newsletter_list

Update newsletter list.

beehiiv_update_newsletter_list_subscription

Update newsletter list subscription.

beehiiv_update_newsletter_list_subscription_by_subscription_id

Update newsletter list subscription by subscription ID.

beehiiv_update_tier

Update a tier.

beehiiv_update_tier_put

Update a tier.

beehiiv_update_webhook

Update webhook.

beehiiv_accept_ad_offer

Accept ad offer.

beehiiv_create_data_deletion_request

Create data deletion request.

beehiiv_create_post_template

Create post template.

beehiiv_create_subscription_export

Create subscription export.

beehiiv_find_publications_by_subscription_email

Get publications by subscription email.

beehiiv_get_account_ad_network_report_summary

Get account ad network report summary.

beehiiv_get_ad_network_report_summary

Get ad network report summary.

beehiiv_get_automation

Get automation.

beehiiv_get_automation_journey

Get automation journey.

beehiiv_get_data_deletion_request

Get data deletion request.

beehiiv_get_poll

Get poll.

beehiiv_get_post_template

Get post template.

beehiiv_get_subscription_export

Get subscription export.

beehiiv_get_workspace_permissions

Get workspace permissions.

beehiiv_list_ad_network_reports

Get ad network reports.

beehiiv_list_ad_offer_advertisements

Get ad offer advertisements.

beehiiv_list_ad_offers

Get ad offers.

beehiiv_list_automation_emails

List automation emails.

beehiiv_list_automation_journeys

List automation journeys.

beehiiv_list_data_deletion_requests

List data deletion requests.

beehiiv_list_poll_responses

List poll responses.

beehiiv_list_post_templates

Get post templates.

beehiiv_list_subscription_exports

List subscription exports.

beehiiv_get_author

Get author.

beehiiv_get_complimentary_access

Get complimentary access.

beehiiv_get_condition_set

Get condition set.

beehiiv_list_authors

List authors.

beehiiv_list_complimentary_access

List complimentary access.

beehiiv_list_condition_sets

List condition sets.

beehiiv_identify_user

Identify user.

beehiiv_list_advertisement_opportunities

Get advertisement opportunities.

Connect beehiiv to your AI

Credentials off one beehiiv screen, then an endpoint your client signs into. Nothing to deploy, and nothing to install.

In beehiiv, open Settings, then Workspace Settings, then API, and create a key (Owner or Admin only; it is shown once). Paste it into the API key field, then pick the publications to connect and the PopMCP workspace each one goes into.

API key••••••••••••3f7a
ConnectionVerified

Then just ask for the work

  • “Find ada@northwind.co, tag her vip and add her to the Pro Tips newsletter list”

    • get_subscription_by_email
    • add_subscription_tags
    • list_newsletter_lists
    • add_newsletter_list_subscription
  • “Which of last month's posts had the best click rate, and what were the totals across all of them”

    • list_posts
    • get_posts_aggregate_stats
  • “Turn these notes into next Tuesday's issue as a draft, then send a test to me”

    • create_post
    • get_post
    • send_post_test_email
  • “Make a segment of everyone whose Plan field is Pro and show me who is in it”

    • list_custom_fields
    • create_segment
    • list_segment_members

Use beehiiv from the assistant you already open

One hosted endpoint, registered once per client. The same tools and the same permissions, whichever window the request comes from.

Claude DesktopCustom connector

Add the PopMCP URL under Settings → Connectors and the tools appear in every chat.

Claude WebCustom connector

The same endpoint, registered in the browser. Nothing to install on the machine you are working from.

ChatGPTCustom connector

Register PopMCP as a custom connector, then let ChatGPT read and update the account.

CodexDesktop & CLI

Wire the endpoint into Codex or the Codex CLI when a task needs live business context, not a fixture.

OpenCodeCoding agent

Register the remote MCP server in OpenCode's config for terminal-first and scripted agent runs.

ZCodeDesktop app

Add PopMCP as an MCP server in Z.ai's desktop app and work the account from the same window.

beehiiv MCP server questions

What teams ask before putting beehiiv behind an AI client.

What API key does the beehiiv MCP server need?

One beehiiv workspace API key. Create it in beehiiv under Settings, then Workspace Settings, then API, with Create New API Key; you need to be a workspace Owner or Admin, and beehiiv shows the key only once. It never expires and needs no OAuth app. PopMCP checks it by listing the publications it reaches, stores it encrypted and sends it from the server as a Bearer token, so your AI client never sees it.

Can I connect more than one beehiiv publication to Claude or ChatGPT?

Yes, one per PopMCP workspace. After you paste the key, PopMCP lists every publication it can reach (the whole beehiiv workspace, or only the ones the key is restricted to), and you pick which to connect and the PopMCP workspace each one goes into. Each connection is pinned to its publication, so the AI never passes a publication id and cannot reach one mapped to another workspace. Add more later with Add publications in My MCP.

Does the AI send beehiiv posts straight to subscribers?

No, not unless it marks the post confirmed. A post created without a status is published and emailed by beehiiv at once, so PopMCP saves every create_post as a draft unless the AI passes a status, or as confirmed when it sets scheduled_at, which schedules it. The tool description tells the AI to send confirmed only when you asked to publish or schedule. send_post_test_email mails a test to the addresses you name, and creating or updating posts needs a beehiiv Max or Enterprise plan.

Does deleting a beehiiv subscriber through AI remove them permanently?

Yes. delete_subscription erases the subscriber and all their data and stops billing a premium subscriber, so it is left out of the default tools and the AI is steered to update_subscription with unsubscribe set to true, which can be undone. delete_post archives a sent or scheduled post and only deletes a draft outright. create_data_deletion_request is workspace-wide and redacts the subscriber from every publication after a 14-day delay.

Can AI read beehiiv open and click rates?

Yes. get_publication with stats expanded returns active free and premium subscriber counts, average open and click rates and total sent. list_posts with stats adds opens and clicks per post, get_posts_aggregate_stats totals them across matching posts with the top 1,000 clicked URLs, and get_engagements breaks email engagement down by day, week or month over up to 31 days. For large publications, beehiiv serves the totals from an hourly cache.

Which beehiiv events can PopMCP watch?

32 in total. 26 are beehiiv webhook events: new, confirmed and deleted subscribers, upgrades to paid and downgrades to free, paused and resumed subscriptions, paid tiers added, removed, paused or resumed, posts sent, scheduled or updated, newsletter list joins, leaves, pauses and resumes, survey responses, and podcast episode and private feed changes. Change detection adds new segments, custom fields, newsletter lists, automations, polls and paid tiers.

Do I have to run or host the beehiiv MCP server myself?

No. PopMCP hosts it and gives you a Streamable HTTP MCP URL. There is nothing to deploy, no callback URL to register, and no infrastructure to keep running or patch.

Which AI clients can use this MCP server?

Any client that supports a remote Streamable HTTP MCP server: Claude Desktop, Claude Web, ChatGPT custom connectors, Codex and the Codex CLI, OpenCode and Z.ai's ZCode, as well as editors such as Cursor, Windsurf and Zed. Your client signs in to PopMCP with OAuth; the provider credential never leaves the server.

Why do only 33 of the 104 tools load by default?

Loading 104 tool definitions into every conversation burns context before the work starts. PopMCP loads a curated 33-tool set covering the everyday workflows and keeps the rest searchable, so your AI pulls a specialist tool only when a task needs it. Every tool stays searchable, and on Scale the owner can load the full catalog for a teammate's connection.

What is the difference between a tool and a trigger?

A tool is something your AI calls, and there are 104 here. A trigger is something PopMCP watches for you: 32 beehiiv events that can start work on the PopMCP side. Triggers never enter your AI client's context, and none of them ask you to paste a callback URL into beehiiv.

Connect beehiiv to your AI in minutes

Launch a hosted MCP endpoint for beehiiv, keep tool access under control, and start testing real workflow prompts right away.

Connect your first MCP