otherapi_key

Beehiiv

Beehiiv is a newsletter platform for managing publications, subscribers, posts, automations, audience engagement, and monetization.

Verdict

The Beehiiv MCP turns Switchy into a content operations hub for newsletter teams. @mention it to draft posts from research threads, build subscriber segments from conversation context, or audit publication performance without leaving your workspace. Writers get faster drafts; growth teams get on-demand audience queries; editors get cross-publication visibility if your key spans multiple pubs. The MCP never publishes or emails — it stages drafts and manipulates subscriber data, so you still control the send button in Beehiiv's dashboard. You'll need an API key with read-write scope across publications, custom fields, and segments.

Common use cases

  • Draft newsletter issues from Slack threads
  • Build subscriber segments during campaign planning
  • Audit post performance across publications
  • Add new subscribers with attribution metadata
  • Query custom field schemas before import

Integration

Vendor
Beehiiv
Category
other
Auth
API_KEY
Tools
11
Composio slug
beehiiv

Tools

  • Create Draft Post

    Create 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 creation finishes.

  • Create Segment

    Create an audience segment from explicit subscription IDs, explicit emails, or custom-field rules; returns the segment and its initial calculation status.

  • Create Subscription

    Create 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 Fields

    List 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 retrieving additional fields.

  • List Posts

    Search a publication's posts by status, audience, channel, slug, tags, or author and optionally include content, recipients, or statistics.

  • List Publications

    List publications accessible to the API key, optionally including publication statistics; use the returned publication IDs with publication-scoped tools.

  • List Segment Members

    List 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 Segments

    List audience segments in a publication, filtered by segment type or calculation status, with optional latest statistics.

  • List Subscriptions

    Search a publication's subscriptions by exact email or filter by status and tier, returning one cursor-controlled page of subscriber records.

  • Update Draft Post

    Update 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 Fields

    Set or remove custom-field values on one subscription without changing its email, tier, billing link, or subscribed status.

Setup

Setup guide

  1. 11. In your Beehiiv account settings, navigate to Integrations > API and generate a new API key with permissions for posts, subscriptions, segments, and custom fields. 2. Copy the key to your clipboard. 3. Open Switchy, click Integrations in the left sidebar, then find Beehiiv in the MCP directory. 4. Click Connect, paste your API key into the prompt, and save. 5. Switchy will verify the key by fetching your publication list — if it fails, double-check the key's scope in Beehiiv. 6. Create or open a Project, type '@Beehiiv list my publications' in the chat, and confirm you see publication names and IDs. 7. To test write access, ask '@Beehiiv create a draft post in [publication ID] with the title Test Draft' — then check your Beehiiv dashboard for the new draft under Posts.

What teammates see: by default, memories from Beehiiv are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Projects have used this MCP together with a given model.

How Switchy teams use it

Not enough Projects yet to publish anonymised usage stats (we require ≥ 50 Projects per week).

Starter prompts

Draft From Research

@Beehiiv create a draft post in publication [paste ID] with the title 'Weekly Roundup' using this content: [paste notes]. Format as HTML with h2 headers and paragraph tags.

Segment High Engagers

@Beehiiv create a segment in publication [paste ID] named 'High Engagement Q1' that includes subscribers where open_rate is greater than 40 and last_click is within 30 days.

Audit Recent Posts

@Beehiiv list posts in publication [paste ID] with status published, limit 5, and include statistics. Show me the title, publish date, open rate, and click rate for each.

Add Subscriber With Context

@Beehiiv create a subscription in publication [paste ID] for email [paste address] with utm_source set to 'partner_webinar' and custom field 'signup_context' set to 'Q1 2025 event'.

Export Segment Members

@Beehiiv list members of segment [paste ID] in publication [paste ID], include custom fields and tags, and show me the first 50 records with email, subscription date, and all metadata.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@beehiiv create a draft post titled 'Q1 Product Roadmap' with a summary of our three biggest feature launches, then confirm the draft ID so I can review it in Beehiiv

Output

Draft post created successfully. Post ID: pst_9x4k2m1n. Title: 'Q1 Product Roadmap'. The post includes HTML content summarizing your three feature launches with headers and bullet formatting. This draft is unscheduled and unpublished—it will not send to subscribers until you manually publish or schedule it in the Beehiiv dashboard. Beehiiv processes post creation asynchronously, so content rendering may take 10–15 seconds to appear in your account.

Notes

Demonstrates the Create Draft Post tool, which generates HTML from your prompt but never publishes automatically. The returned post ID is stable immediately, but Beehiiv's backend may still be rendering the content. Always review drafts in the dashboard before scheduling—AI-generated HTML can have formatting quirks that need manual polish.

Prompt

@beehiiv create a new audience segment called 'High Engagement Readers' for subscribers who opened at least 5 of the last 10 emails, then show me the initial member count

Output

Segment 'High Engagement Readers' created with ID seg_7h3p9w2q. Initial calculation status: processing. Beehiiv is evaluating your custom-field rules against 8,432 total subscribers. Segment calculations typically complete in 30–90 seconds for lists under 10,000 subscribers. Once calculated, you can use this segment ID to target future campaigns or list members with full subscriber details. Check calculation status with the List Segments tool or view the segment in your Beehiiv dashboard.

Notes

Uses the Create Segment tool with custom-field logic. Segment creation is asynchronous—the returned ID is valid immediately, but member counts aren't final until calculation completes. Requires write scope. Segments based on engagement metrics depend on accurate open/click tracking, which may be incomplete for privacy-focused email clients.

Use-case deep-dives

Newsletter launch for B2B SaaS

When Beehiiv MCP fits early-stage content ops

A three-person marketing team at a Series A company wants to draft newsletters in Switchy using AI research, then push drafts to Beehiiv for final review and scheduling. The Create Draft Post tool handles this cleanly: you write in Switchy, the MCP ships HTML to Beehiiv as an unscheduled draft, and your editor clicks publish in the Beehiiv UI. The workflow breaks down if you need inline scheduling or A/B test setup—those require manual handoff. If your team publishes more than twice a week, the round-trip gets tedious; at that cadence you're better off drafting directly in Beehiiv. For teams publishing weekly or biweekly and using Switchy for research synthesis, this MCP saves the copy-paste step without forcing you to abandon Beehiiv's native scheduling tools.

Subscriber segmentation for product launches

Beehiiv MCP wins for audience-list prep

A five-person product-marketing team needs to build a segment of trial users who haven't upgraded, then export that list for a targeted launch campaign. The List Custom Fields and Create Segment tools let you define the segment logic in Switchy—pull custom-field definitions, write the rule set, create the segment, then retrieve the member list with full subscriber records. This works when your segment logic is straightforward (one or two custom-field filters) and you're building the list once or twice a quarter. If you're running daily segmentation or need multi-step funnel logic, the MCP's async segment calculation becomes a bottleneck; you'll wait for status updates instead of seeing instant results. For infrequent, well-defined audience pulls, the MCP keeps your team in one workspace without opening Beehiiv's segment builder.

Support-ticket subscriber lookup

When Beehiiv MCP handles one-off subscriber queries

A two-person support team fields questions about newsletter delivery or subscription status and needs to look up subscriber records without leaving Switchy. The List Segments and List Segment Members tools let you search by email or custom field, retrieve the subscriber's current status, and confirm tier or referral data in under ten seconds. This scenario works if you're handling fewer than twenty lookups a day and your publication has under five segments; beyond that threshold, the MCP's pagination and async segment refresh make it slower than Beehiiv's native search. The MCP also exposes full PII in responses, so your Switchy workspace needs appropriate access controls. For low-volume support lookups where you're already triaging in Switchy, the MCP eliminates the context switch to Beehiiv's dashboard.

Frequently asked

What does the Beehiiv MCP let me do in Switchy?

It lets your AI agents create draft posts, manage subscriber segments, add new subscriptions, and query your publication's posts and audience data. Agents can build drafts from HTML, filter subscribers by custom fields, and pull post analytics — but they can't publish, schedule, or send anything without your explicit approval.

Do I need admin access to connect Beehiiv?

You need an API key from your Beehiiv account settings. Beehiiv doesn't expose granular scopes, so the key grants full read-write access to publications, posts, subscribers, and segments. Only connect it if you trust your team not to accidentally modify subscriber lists or create unwanted drafts.

Can the MCP publish or send a newsletter for me?

No. The Create Draft Post tool explicitly never confirms, publishes, schedules, or sends. It only stages HTML content as an unscheduled draft. You still log into Beehiiv to review, schedule, and send. This prevents agents from accidentally mailing your entire list.

Why use this instead of Beehiiv's web dashboard?

Use the MCP when you want an agent to draft posts from research, build audience segments from CRM data, or pull subscriber stats into a report. Use the dashboard when you need Beehiiv's visual editor, scheduling calendar, or A/B test controls — the MCP doesn't touch those workflows.

Who on my team should connect the Beehiiv integration?

Whoever owns your newsletter strategy and has API-key access in Beehiiv. Since the key grants full publication access, don't share it across the whole team. One person connects it; everyone else uses Switchy's permission controls to decide which agents can call Beehiiv tools.

More other MCPs

See all other MCPs →

Data last verified 61 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.