briefkin

Email marketing · 1 skill

beehiiv MCP: connect it to Claude Code, plus ready-made skills

Pull post opens, clicks, subscriber growth and unsubscribes from beehiiv, and post a weekly newsletter report with the issue that did best.

How to connect beehiiv MCP to Claude Code, Codex or Cursor

  1. beehiiv MCP, beehiiv's official remote server at https://mcp.beehiiv.com/mcp. In beehiiv, open Settings > MCP, pick your client (beehiiv has guides for Claude, Claude Code, Cursor and Codex) and grant access when asked. It is available on every plan: free plans are read-only, and paid plans add write tools for content, segments and automations, though it can't publish, schedule or send posts. To connect a second workspace, add a parameter such as ?account=2 to the URL (docs).
  2. API v2 with an API key. Create a key in your beehiiv settings, store it in BEEHIIV_API_KEY with BEEHIIV_PUBLICATION_ID (it starts with pub_), and send it as a Bearer token.

The endpoints this report reads need only posts:read, subscriptions:read and publications:read. On a paid plan the MCP connection can edit drafts and segments, so keep it for interactive work and use a read-only key for scheduled runs.

1 beehiiv skill

Which emails made money: Mailchimp, Klaviyo or Beehiiv, analytics and sales

Every Monday: each recent email's sessions, sign-ups and sales in the 7 days after it went out, joined on its utm_campaign, next to the open rate.

MarketingMondays at 9:30Report cardUses Mailchimp, Klaviyo, beehiiv, Google Analytics, Stripe, Gumroad.

What agents do with beehiiv

beehiiv's API v2 (https://api.beehiiv.com/v2) is organized by publication. GET /publications/{publicationId}/posts lists posts with their status and publish date, and expand[]=stats adds email recipients, opens, open rate, clicks and click rate, plus web views. GET /publications/{publicationId}/subscriptions lists subscribers with their status, created date and where they came from (utm_source, referring_site), and expanding the publication itself returns totals such as active subscriptions and average open and click rates. Responses page with page and limit, so a weekly report asks only for posts published since the last run.

Newsletter writers schedule a weekly report of last week's posts ranked by open and click rate, net subscriber growth (new minus unsubscribed), the sources new readers came from, and a monthly look at the trend in average open rate.

beehiiv.com

Often used with beehiiv

Teams that use these

Your beehiiv numbers, on one board with everything else

Skills are free to use with any agent. Briefkin is where their results land: one board for every report, number and question your agents send, with a ping when something needs you.

Join the open betaSee a live demo board

Free during the open beta. No card.