Manage your newsletter right inside Gumloop. The Beehiiv MCP node lets you publish posts, grow your subscriber base, and sync data to the rest of your workflow in just a few clicks.
Control every part of your Beehiiv publication - from posts to tiers - through one MCP-powered node.

​
What is Beehiiv MCP?

Beehiiv MCP turns plain-English prompts into Beehiiv API calls. Describe the outcome you need, and the node returns clean, structured data ready to flow into the next step of your automation.

​
What Can It Do for You?

  • Publish, update, or archive posts automatically
  • Add or modify subscribers, tags, and custom fields
  • Retrieve segments, tiers, and automations for targeted campaigns
  • Pipe Beehiiv data into Google Sheets, Slack, and more for real-time reporting

​
Available Tools

ToolWhat It DoesExample Use
List AutomationsList automations in a Beehiiv publication”List automations for publication ‘Tech Weekly Newsletter’ and return id, name, and status”
Create Custom FieldCreate a custom field on a Beehiiv publication”Create a custom field called ‘company_size’ of type dropdown in publication ‘SaaS Insights’ and return field_id”
List Custom FieldsList all custom fields on a Beehiiv publication”List custom fields for publication ‘Marketing Digest’ and return name and field_id”
Create PostCreate a new post in a Beehiiv publication”Create a post titled ‘AI Tools Roundup - March 2024’ with status ‘draft’ in publication ‘Tech Weekly’ and return post_id and url”
List PostsRetrieve posts belonging to a Beehiiv publication”List the 10 most recent posts in publication ‘Startup Stories’ and return post_id, title, and status”
Get PostRetrieve a single post”Get post titled ‘Year in Review 2024’ from publication ‘Industry Analysis’ and return title, url, and status”
Delete PostArchive or delete a post”Archive post ‘Test Email - Please Ignore’ in publication ‘Dev Newsletter’ and confirm success”
List SegmentsList segments for a publication”List segments for publication ‘B2B Marketing’ and return segment_id and name”
Get SegmentGet details for one segment”Get segment ‘Premium Members’ from publication ‘Finance Daily’ and return name and subscriber_count”
List Segment SubscribersList subscribers in a segment”List subscribers in segment ‘VIP Readers’ and return subscriber_id and email”
Create SubscriptionAdd a new subscriber”Subscribe sarah.jones@company.com to publication ‘Product Updates’ and return subscription_id and status”
List SubscriptionsList subscriptions for a publication”List active subscriptions for publication ‘Developer News’ and return email and status”
Get Subscription By EmailRetrieve a subscription by email”Get subscription for john.smith@example.com in publication ‘Cloud Computing Weekly’ and return subscription_id and tier”
Get SubscriptionRetrieve a subscription by ID”Get subscription for user ‘mike@startup.io’ from publication ‘Founder’s Journey’ and return email, status, and tier”
Update SubscriptionUpdate subscription details”Update subscription for emma@tech.com to tier ‘Premium’ and return status”
Delete SubscriptionRemove a subscription”Delete subscription for test@testaccount.com from publication ‘Beta Newsletter’ and confirm removal”
Add Subscription TagTag a subscription”Add tag ‘enterprise_customer’ to subscription for cto@bigcorp.com and return updated_tags”
List TiersList tiers for a publication”List tiers for publication ‘Creator Economy’ and return tier_id, name, and price”
Create TierCreate a new tier”Create a tier called ‘Founding Member’ priced at 25 USD/month in publication ‘Indie Hackers Weekly’ and return tier_id”

​
How to Use

1

Create Your Beehiiv MCP Node

Go to your node library, search for Beehiiv, and click “Create a node with AI”
2

Add Your Prompt

Drag the Beehiiv MCP node to your canvas and add your prompt in the text box.
3

Test Your Node

Run the node to see the results. If it works as expected, you’re all set! If you run into issues, check the troubleshooting tips below.
4

Save and Reuse

Once your Beehiiv MCP node is working, save it to your library. You can now use this customized node in any workflow.

​
Example Prompts

With 19 available tools, these examples show common use cases. Feel free to adapt them for your publication. Create a Post 
Create a post titled "Product Launch Recap" with status draft in the provided publication and return post_id, title, and url
List Segment Subscribers 
List subscribers in the provided segment for publication 987 and return subscriber_id and email
Create a Subscription 
Subscribe the provided email address to publication 987 with tier_id 12 and return subscription_id, email, and status
Update a Subscription 
Update the provided subscription_id in publication 987 to status paused and return subscription_id and status
List Tiers 
List tiers for publication 987 and return tier_id, name, and price
Get a Single Post 
Given a post URL from publication 987 and return title, status, and published_at
Start with a clear, focused action such as “List posts” or “Create subscription”. Once that works smoothly, chain multiple Beehiiv nodes together for advanced automation.

​
Troubleshooting

If your Beehiiv MCP node isn’t working as expected, try these best practices:

​
Keep Prompts Simple and Specific

  • Good: “List posts in publication 987 and return post_id and title”
  • Needs Improvement: “List posts, then create a draft post, and finally email me the results”
For best results, give Beehiiv MCP one clear task. Combine multiple nodes to build multi-step workflows.

​
Match What Beehiiv Can Do

  • Good: “Add tag ‘VIP’ to subscription 321”
  • Needs Improvement: “Generate an email newsletter design and then post it to Beehiiv”
Beehiiv MCP excels at newsletter data management. Design generation would be outside of the capabilities of this MCP server.

​
Break Complex Tasks Into Steps

Trying to handle everything in one prompt can cause timeouts and make debugging harder: 
Create a 'Black Friday' segment, list all subscribers from the USA, tag them as 'Sale', create a post announcing the sale, and send it to that segment
A more efficient approach is to split the work:
1

Step 1: Create Segment

Create a segment named “Black Friday USA” in publication 987 and return segment_id
2

Step 2: List Subscriptions

List subscriptions in publication 987 filtered by country = “USA” and return subscription_id
3

Step 3: Add Tags

Add tag “Sale” to the provided subscription_ids in publication 987 and return updated_tags
4

Step 4: Create Post

Create a post titled “Black Friday Deals” with status draft in publication 987 and return post_id
Connect these nodes sequentially in your workflow. For example, pass the segment_id output from Step 1 to any later steps that need it.

​
Focus on Data Retrieval

Beehiiv MCP is great at getting information from your publication. For analysis or content creation, hand the data off to other nodes. Example:
  • Good prompt: “Get post 789 and return title and url”
  • Needs Improvement: “Get post 789, summarize its content, and generate three tweet ideas”
Use Beehiiv MCP to retrieve the post, then send the content to Ask AI for summarization or idea generation.

​
Troubleshooting Node Creation

​
Need More Help?