Connect Buttondown to Your AI Agent

Choose subscribers by email or ID to review their recorded details and apply a requested note change.

Try a Buttondown Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Buttondown

Review Subscriber Details

Inspect subscriber status and associated record fields.

/oo Buttondown: Read Buttondown subscriber [email or subscriber ID] and list tags. Summarize their returned subscriber details and tag information.

Update Subscriber Notes

Save supplied private notes on an identified subscriber.

/oo Buttondown: Update Buttondown subscriber [email or subscriber ID] with private notes “[notes]”. Report the returned subscriber record.

Start Working with Buttondown

Install OOMOL

Set up oo CLI and the oo Skill in your agent.
Install OOMOL →
Connect Buttondown

Connect a Buttondown API key.
Connect Buttondown →
Give Your Agent a Task

Use /oo with the pages to read, the changes to make, and where to save the result.
Connection Guide →

Choose Your Agent

Codex Claude Code Cursor Hermes

Access to the subscriber records you want to use.
Subscriber lookups accept an ID or email address. Adding or changing a subscriber is separate from sending a newsletter.

Buttondown Tools

This connection reads account and newsletter information and manages subscriber records and tags.

Subscriber Records

Read and explicitly create or change subscribers.

Tag Organization

Read or manage tags used in subscriber records.

12 tools

Get Account

Get the account associated with the Buttondown API key.

buttondown.get_account

List Newsletters

List newsletters available to the Buttondown API key.

buttondown.list_newsletters

List Subscribers

List Buttondown subscribers with common filters.

buttondown.list_subscribers

Get Subscriber

Retrieve one Buttondown subscriber by ID or email address.

buttondown.get_subscriber

Create Subscriber

Create a Buttondown subscriber.

buttondown.create_subscriber

Update Subscriber

Update a Buttondown subscriber by ID or email address.

buttondown.update_subscriber

Delete Subscriber

Delete a Buttondown subscriber by ID or email address.

buttondown.delete_subscriber

List Tags

List Buttondown tags.

buttondown.list_tags

Create Tag

Create a Buttondown tag.

buttondown.create_tag

Get Tag

Retrieve one Buttondown tag by ID.

buttondown.get_tag

Update Tag

Update a Buttondown tag by ID.

buttondown.update_tag

Delete Tag

Delete a Buttondown tag by ID.

buttondown.delete_tag

Frequently Asked Questions

Can I find a subscriber by email?

Yes. Individual subscriber retrieval accepts either a subscriber ID or email address.

Can I store private context for a subscriber?

Subscriber creation and updates accept private notes. Creation also accepts structured metadata and attribution fields.

Can I send newsletter emails here?

The available operations cover subscribers, tags, and account records. Email drafting and sending are not included.