Start free
    Menu
    How it worksIntegrationsCustomersPricingSign in

    integrations tools beehiiv

    beehiiv MCP for your AI agent

    Cogny's beehiiv integration exposes 17 tools (13 read, 4 write) to an AI agent over MCP. The same tools are available on every plan, from your own AI client or inside the Cogny app.

    • 13readonly reads data.
    • 4writecreates or changes something.
    • 0destructivedeletes, removes or replaces something.

    Over MCP your own AI client asks before it runs a write. To take a tool away from your agent, block it in Settings → Integrations. Plans, approvals and limits

    set it up.

    Add Cogny to your AI client once, then connect beehiiv in Cogny. Every beehiiv tool below appears in the client.

    • Claude CodeRun claude mcp add --transport http cogny https://app.cogny.com/mcp, then authorise in the browser.
    • Claude.aiSettings → Connectors → Add custom connector, URL https://app.cogny.com/mcp, then log in and pick your workspace.
    • ChatGPTSettings → Apps → Advanced settings → Developer mode → Create app, URL https://app.cogny.com/mcp, authentication OAuth.
    • CursorIn Cogny, Settings → Data & Integrations → Connect AI Clients shows the block to paste into .mcp.json, with an API key.
    • CodexRun codex mcp add cogny --url https://app.cogny.com/mcp.

    Full setup, and how to undo it

    what each tool does.

    Read 13 · only reads data

    • list_publicationsReadList the beehiiv publications your API key can access.
    • get_publicationReadGet one beehiiv publication.
    • list_postsReadList posts of a publication with their performance stats.
    • get_postReadGet a single beehiiv post.
    • get_posts_aggregate_statsReadGet aggregate stats (recipients, opens, clicks) across a publication's posts.
    • list_subscriptionsReadList subscribers of a publication.
    • get_subscription_by_emailReadLook up a subscriber by email address.
    • get_subscription_by_idReadGet a subscriber by its subscription id.
    • list_segmentsReadList segments of a publication.
    • get_segmentReadGet a single segment.
    • list_segment_subscribersReadList the subscribers in a segment.
    • list_automationsReadList automations of a publication.
    • list_automation_journeysReadList the journeys of an automation.

    Write 4 · creates or changes something

    • create_postWriteCreate a beehiiv post as a DRAFT.
    • create_subscriptionWriteCreate a beehiiv subscriber, or update the existing one with that email.
    • update_subscriptionWriteUpdate an existing beehiiv subscriber (idempotent).
    • add_subscription_to_automationWriteEnrol a subscriber in an automation.

    Exact input schemas come from tools/list once beehiiv is connected; the free plan is enough to check. Missing something? Your agent can ask for it with request_feature.

    This page as markdownAll integrations