beehiiv MCP: newsletters and subscribers in your AI app

Bring beehiiv into Claude, ChatGPT or Cursor

1. 1Click Connect Beehiiv free and sign in with your beehiiv account.
2. 2Decide how far your AI app goes with your audience. Keep post and subscriber lookups, and switch off the tools that add subscriptions, build segments or change custom fields if a person should make those changes.
3. 3Add ContextGate to your AI app as a connector or MCP server. The steps for each app are on the Works with page.
4. 4Ask your AI app for your last five beehiiv posts with their stats, then open Activity to see the call.

Newsletter tasks for Claude or ChatGPT

• Write a post in chat and save it to beehiiv as an unscheduled draft, then revise it while it's still a draft.
• Search posts by status, audience, tag or author, with stats included.
• Find a subscriber by email, or filter subscriptions by status and tier.
• Build an audience segment from emails or custom-field rules and list who's in it.

In ContextGate's app connector, saving a draft never publishes, schedules or sends the post.

Protect your subscriber list

• Switch off subscription and segment tools so your AI app can read your audience but not change it.
• Policies check every call and can hide subscribers' email addresses and other personal data.
• Activity records every draft, lookup and change made through beehiiv.

What you get with Beehiiv and ContextGate

• Your AI apps can use BeehiivClaude, Cursor, ChatGPT and other AI apps reach Beehiiv through the one ContextGate connection you add to them.
• You choose which tools they can useSwitch off any Beehiiv tool you don't want used. It's hidden from your AI apps and refused if called.
• Every call is checked and recordedYour policies check each call (for example, personal data is hidden and secrets are blocked), and Activity keeps a record of it.

ContextGate sees only the tool calls that go through it, not your AI app's built-in tools or your chats.

Beehiiv tools

Examples of what your AI apps can do in Beehiiv. You'll see the exact list of tools after you connect it.

• Create Draft PostCreate an unscheduled draft post from HTML content. This tool never confirms, publishes, schedules, or sends the post. Beehiiv creates posts asynchronously; the returned ID is stable while background
• Create SegmentCreate an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status.
• Create SubscriptionCreate a new publication subscription without reactivating an unsubscribed address or sending a welcome email; supports attribution, initial custom fields, and newsletter-list assignment.
• List Custom FieldsList the custom-field definitions available for subscriber metadata and dynamic audience segments in a publication, returning one page controlled by page and limit with pagination metadata for retriev
• List PostsSearch a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.
• List PublicationsList publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.
• List Segment MembersList full subscriber records currently included in an audience segment, optionally including stats, custom fields, referrals, tags, or premium tiers. The response contains subscriber PII.
• List SegmentsList audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.
• List SubscriptionsSearch a publication's subscriptions by exact email or filter by status and tier, returning one cursor-controlled page of subscriber records.
• Update Draft PostUpdate content or presentation settings on an existing draft after verifying it is still a draft; refuses confirmed, archived, or sent posts and cannot publish or schedule.
• Update Subscription Custom FieldsSet or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.