Integration · Email

Connect Claude & ChatGPT to Buttondown

Ask your AI how your last newsletter performed, who signed up this month, or to draft the next issue in Buttondown. It can add, tag and update subscribers, create and edit emails, send a test to yourself and read analytics for sent emails. It also works with automations, segments, surveys and the comments readers leave.

Connect Buttondown free

Free plan, no credit card. Takes about a minute.

Try asking

“How did last week's newsletter do?”
The AI finds the email and reads its analytics: deliveries, opens, clicks, unsubscribes and more.
“Add [email protected] as a subscriber with the tag 'customers'.”
It adds the subscriber with the tag. Depending on your newsletter settings, she may get a confirmation email.
“Draft next week's issue from these notes, but do not send it.”
It creates the email as a draft with subject and body, so nothing goes out to your subscribers.

What your AI can do

Subscribers and tags

Search, add and update subscribers with tags, notes and metadata, create and edit tags, and work with saved segments.

Emails and analytics

Create, edit and schedule emails, send test drafts, and read deliveries, opens, clicks and subscriber events.

Automations and more

List and edit automations, read surveys and their responses, moderate comments and manage forms and webhooks.

“Send the draft to me as a test first.”
It sends the draft to the addresses you name, without sending it to the whole list.
“Who unsubscribed in the last 30 days?”
It lists subscribers filtered by type and date range.
“Are there new comments on our emails I should approve?”
It lists recent comments and can approve a comment or mark it as spam.

129 tools for Buttondown

These tools are switched on when you connect. You can switch any of them off, or require your approval before it runs.

create_automationChanges dataCreate a new automation. Required: name, trigger or actions. API summary: Create Automation.
create_automation_invokeChanges dataCreate a new invoke for a automation. API summary: Invoke Automation.
create_bookVisible to othersCreate a new book. Required: title. Has effects visible outside this system. API summary: Create Book.
create_bulk_actionVisible to othersCreate a new bulk action. Required: type or metadata. Has effects visible outside this system. API summary: Create Bulk Action.
create_emailDeletesCreate an email with `subject` and `body` (Markdown or HTML). Warning: by default Buttondown sends it to your subscribers right away; set `status` to draft to only save it, or scheduled with a `publish_date`.
create_exportChanges dataCreate a new export. Required: collections. API summary: Create Export.
create_external_feedChanges dataCreate a new external feed. Required: url, behavior, cadence, filters, subject or body. API summary: Create External Feed.
create_external_feed_productChanges dataCreate a new product for a external feed. API summary: Poll Items.
create_formChanges dataCreate a new form. Required: title or slug. API summary: Create Form.
create_messageChanges dataCreate a new message. Required: text. API summary: Create Comment.
create_newsletterChanges dataCreate a new newsletter. Required: description, name or username. API summary: Create Newsletter.
create_note_endpointChanges dataCreate a new message. Required: body, model type or model id. API summary: Create Note Endpoint.
create_priceChanges dataCreate a new price. Required: cadence, currency or style. API summary: Create Price.
create_segmentChanges dataCreate a new segment. Required: name or filters. API summary: Create Segment.
create_snippetChanges dataCreate a new snippet. Required: identifier or name. API summary: Create Snippet.
create_subscriberChanges dataAdd a subscriber by `email_address`, with optional tags, notes, metadata and UTM source. Depending on your newsletter settings they may receive a confirmation email.
create_surveyChanges dataCreate a new survey. Required: identifier, question or answers. API summary: Create Survey.
create_survey_responseChanges dataCreate a new survey response. Required: subscriber id, survey id, email id or answer. API summary: Create Survey Response.
create_tagChanges dataCreate a subscriber tag with `name`, `color` (hex) and optional description.
create_unitChanges dataCreate a new unit. Required: title. API summary: Create Advertising Unit.
create_userChanges dataCreate a new user. Required: permissions or email address. API summary: Create User.
create_webhookDeletesCreate a new webhook. Required: event types or url. Destructive action; may require approval. API summary: Create Webhook.
create_webhook_testDeletesCreate a new test for a webhook. Destructive action; may require approval. API summary: Test Webhook.
delete_automationDeletesPermanently delete a automation by automation id. Destructive action; may require approval. API summary: Delete Automation.
delete_bookDeletesPermanently delete a book by book id. Destructive action; may require approval. API summary: Delete Book.
delete_documentDeletesPermanently delete a document by document id. Destructive action; may require approval. API summary: Delete Attachment.
delete_emailDeletesPermanently delete an email by `message_id`. This cannot be undone.
delete_external_feedDeletesPermanently delete a external feed by external feed id. Destructive action; may require approval. API summary: Delete External Feed.
delete_formDeletesPermanently delete a form by form id. Destructive action; may require approval. API summary: Delete Form.
delete_imageDeletesPermanently delete a image by image id. Destructive action; may require approval. API summary: Delete Image.
delete_importDeletesPermanently delete a import by import id. Destructive action; may require approval. API summary: Delete Import.
delete_messageDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Comment.
delete_newsletterDeletesPermanently delete a newsletter by newsletter id. Destructive action; may require approval. API summary: Delete Newsletter.
delete_note_endpointDeletesPermanently delete a message by message id. Destructive action; may require approval. API summary: Delete Note Endpoint.
delete_priceDeletesPermanently delete a price by price id. Destructive action; may require approval. API summary: Delete Price.
delete_segmentDeletesPermanently delete a segment by segment id. Destructive action; may require approval. API summary: Delete Segment.
delete_snippetDeletesPermanently delete a snippet by snippet id. Destructive action; may require approval. API summary: Delete Snippet.
delete_subscriberDeletesPermanently delete a subscriber by ID or email. This cannot be undone; to just stop emails, update their type instead.
delete_surveyDeletesPermanently delete a survey by survey id. Destructive action; may require approval. API summary: Delete Survey.
delete_tagDeletesPermanently delete a tag by tag id. Destructive action; may require approval. API summary: Delete Tag.
delete_unitDeletesPermanently delete a unit by unit id. Destructive action; may require approval. API summary: Delete Advertising Unit.
delete_userDeletesPermanently delete a user by user id. Destructive action; may require approval. API summary: Delete User.
delete_webhookDeletesPermanently delete a webhook by webhook id. Destructive action; may require approval. API summary: Delete Webhook.
get_accountGet the Buttondown account the connection belongs to. Use to confirm which account you are working in.
get_api_requestGet one api request by api request id. API summary: Retrieve Api Request.
get_automationGet one automation's trigger, filters and actions by `automation_id`.
get_bodyGet one body by history id. API summary: Retrieve Email History By Id.
get_bookGet one book by book id. API summary: Retrieve Book.
get_bulk_actionGet one bulk action by bulk action id. API summary: Retrieve Bulk Action.
get_documentGet one document by document id. API summary: Retrieve Attachment.
get_emailGet one email by `message_id`, including subject, body, status and publish date.
get_email_analyticsGet analytics for a sent email (`email_id`): deliveries, opens, clicks, unsubscribes and more.
get_eventGet one event by event id. API summary: Get Event.
get_exportGet one export by export id. API summary: Retrieve Export.
get_external_feedGet one external feed by external feed id. API summary: Retrieve External Feed.
get_formGet one form by form id. API summary: Retrieve Form.
get_importGet one import by import id. API summary: Retrieve Import.
get_messageGet one message by message id. API summary: Retrieve Comment.
get_newsletterGet one newsletter's settings by `newsletter_id`.
get_segmentGet one segment and its filters by `segment_id`.
get_snippetGet one snippet by snippet id. API summary: Retrieve Snippet.
get_subscriberGet one subscriber by ID or email (`id_or_email`), including tags, notes, type and metadata.
get_surveyGet one survey by survey id. API summary: Retrieve Survey.
get_tagGet one tag by tag id. API summary: Retrieve Tag.
get_userGet one user by user id. API summary: Retrieve User.
get_webhookGet one webhook by webhook id. API summary: Retrieve Webhook.
list_api_requestsList api requests. Optional filters: creation date gt, creation date lt, date end, date start, method or path. Results are paginated.
list_automation_analyticsList analytics for a automation. API summary: Retrieve Automation Analytics.
list_automationsList your automations (e.g. welcome sequences).
list_booksList books. Results are paginated.
list_commentsList comments left on your emails, filtered by `email_id`, `subscriber_id`, `status` or date range.
list_couponsList coupons. Results are paginated.
list_documentsList documents. Optional filters: ids. Results are paginated. API summary: List Attachments.
list_emailsList emails (drafts, scheduled, sent) filtered by `subject`, `status`, publish or creation date range and open/click rates, with paging.
list_eventsList subscriber events (opens, clicks, deliveries and more), filtered by `email_id`, `subscriber_id`, `automation_id` or `event_type`.
list_exportsList exports. Results are paginated.
list_external_feed_productsList products for a external feed. Results are paginated. API summary: Retrieve Items.
list_external_feedsList external feeds. Results are paginated.
list_formsList your signup forms.
list_imagesList images. Optional filters: ids. Results are paginated.
list_importsList imports. Optional filters: ordering. Results are paginated.
list_message_rendersList renders for a message. Optional filters: target. API summary: Retrieve Email Renders.
list_newsletter_hosting_domainsList hosting domains for a newsletter. API summary: Retrieve Hosting Domain.
list_newsletter_sending_domainsList sending domains for a newsletter. Optional filters: force. API summary: Retrieve Sending Domain.
list_newslettersList the newsletters in your account.
list_notesList messages. Optional filters: model type or model id. Results are paginated. API summary: List Notes.
list_pricesList prices. Results are paginated.
list_segmentsList saved subscriber segments.
list_slotsList slots. Results are paginated. API summary: List Advertising Slots.
list_snippetsList snippets. Results are paginated.
list_subscriber_automationsList automations for a subscriber. Results are paginated. API summary: Get Automations.
list_subscriber_referralsList referrals for a subscriber. Results are paginated. API summary: Get Referrals.
list_subscriber_subscriptionsList subscriptions for a subscriber. Results are paginated. API summary: Get Stripe Subscriptions.
list_subscribersList subscribers, filtered by `email_address`, `tag`, `type` (e.g. regular, unsubscribed), `source`, subscribe date range, open/click rates and more, with paging.
list_survey_responsesList survey responses, filtered by `survey_id`, `email_id`, `subscriber_id` or date range.
list_surveysList your surveys.
list_tag_analyticsList analytics for a tag. API summary: Retrieve Tag Analytics.
list_tagsList subscriber tags and their IDs.
list_unitsList units. Results are paginated. API summary: List Advertising Units.
list_usersList users. Results are paginated.
list_webhook_attemptsList attempts for a webhook. Optional filters: status. Results are paginated. API summary: Retrieve Webhook Attempts.
list_webhooksList webhooks. Optional filters: status. Results are paginated.
moderate_commentChanges dataModerate a comment by `message_id`: set `status` to active to approve it or spammy to mark it as spam.
search_message_historiesSearch histories for a message by field, ordering or query. Use this to find existing histories before creating a new history. Results are paginated. API summary: Retrieve Email History.
search_public_emailsGet one message by username. Results are paginated. API summary: Search public emails.
send_messageVisible to othersSend a message (message id). Has effects visible outside this system. API summary: Send Email To.
send_subscriber_magic_linkVisible to othersSend a subscriber (id or email). Has effects visible outside this system. API summary: Send Magic Link To Subscriber.
send_subscriber_reminderVisible to othersSend a subscriber (id or email). Has effects visible outside this system. API summary: Send Reminder.
send_test_emailVisible to othersSend a draft email (`email_id`) as a test to specific `recipients` (email addresses) or `subscribers`, without sending it to the whole list.
submit_messageVisible to othersPublish a message (email id). Has effects visible outside this system. API summary: Publish Email.
update_automationChanges dataUpdate an existing automation identified by automation id. Only the fields you pass are changed. API summary: Update Automation.
update_bookVisible to othersUpdate an existing book identified by book id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update Book.
update_emailDeletesUpdate an email by `message_id`: subject, body, description, publish_date or status (draft, scheduled, about_to_send). Setting status to about_to_send sends it to subscribers.
update_external_feedChanges dataUpdate an existing external feed identified by external feed id. Only the fields you pass are changed. API summary: Update External Feed.
update_formChanges dataUpdate an existing form identified by form id. Only the fields you pass are changed. API summary: Update Form.
update_imageChanges dataUpdate an existing image identified by image id. Only the fields you pass are changed. API summary: Update Image.
update_importChanges dataUpdate an existing import identified by import id. Only the fields you pass are changed. API summary: Update Import.
update_newsletterChanges dataUpdate an existing newsletter identified by newsletter id. Only the fields you pass are changed. API summary: Update Newsletter.
update_segmentChanges dataUpdate an existing segment identified by segment id. Only the fields you pass are changed. API summary: Update Segment.
update_slotChanges dataUpdate an existing slot identified by slot id. Only the fields you pass are changed. API summary: Update Advertising Slot.
update_snippetChanges dataUpdate an existing snippet identified by snippet id. Only the fields you pass are changed. API summary: Update Snippet.
update_subscriberVisible to othersUpdate a subscriber (`id_or_email`): tags, notes, metadata, email_address or type (e.g. to unsubscribe them). Only the fields you pass change.
update_subscriber_automationVisible to othersUpdate an existing automation identified by automation attempt id. Only the fields you pass are changed. Has effects visible outside this system. API summary: Update Automation Attempt.
update_surveyChanges dataUpdate an existing survey identified by survey id. Only the fields you pass are changed. API summary: Update Survey.
update_survey_responseChanges dataUpdate an existing survey response identified by survey response id. Only the fields you pass are changed. API summary: Update Survey Response.
update_tagChanges dataUpdate a tag's name, color or description by `tag_id`.
update_unitChanges dataUpdate an existing unit identified by unit id. Only the fields you pass are changed. API summary: Update Advertising Unit.
update_userChanges dataUpdate an existing user identified by user id. Only the fields you pass are changed. API summary: Update User.
update_webhookDeletesUpdate an existing webhook identified by webhook id. Only the fields you pass are changed. Destructive action; may require approval. API summary: Update Webhook.

Set up in three steps

1
Pick the app
Create a free HeyMyApps account and choose Buttondown from the app list.
2
Paste your key
Paste a Buttondown API key. In Buttondown, open API > Keys and create or copy an API key.
3
Add the link to your AI
You get a personal MCP link. Add it to Claude, ChatGPT or Cursor:
1. Click your name, then Settings › Connectors › Add custom connector.
2. Paste your link as the Remote MCP server URL.
3. Switch it on from the + menu in a chat.

Questions

What can the AI do in Buttondown?

The AI can read and update subscribers, tags, segments, emails, email analytics, subscriber events, automations, surveys, comments, forms and webhooks. It can add subscribers, create and edit emails, send test drafts, publish emails and delete items you switch those tools on for.

Does the AI see my Buttondown credentials?

No. Your Buttondown credentials are encrypted at rest and never shown to the AI. After you save them, they are not shown again, not even to you. The AI only sees the results of the tools it calls.

Can I control what the AI is allowed to do?

Yes. You choose which tools are switched on, so you can start with reading subscribers and analytics. Actions that send email or delete data, like publishing an email or deleting a subscriber, can require your approval before they run. Every tool call is logged.

Does it work with ChatGPT?

Yes. In ChatGPT go to Settings › Apps & Connectors › Advanced and turn on Developer mode, then add your HeyMyApps link. Developer mode needs a paid ChatGPT plan: Plus, Pro, Business or Enterprise. The same link also works in Claude (Settings › Connectors › Add custom connector), Cursor and other MCP clients.

What does it cost?

HeyMyApps has a free plan with no credit card required. Paid plans bill per completed task. You also need your own Buttondown account.

Could the AI send an email to all my subscribers by mistake?

Buttondown sends a new email to your subscribers right away unless it is saved as a draft, so ask the AI for a draft when you are not ready to send. Creating, updating and publishing emails can require your approval, and you can send a test draft to yourself first.