Community Gmail server with auto-auth: search, read and send email via MCP.
Buttondown MCP by usefulapi is installed from its publisher's own source and answers where it runs, so this marketplace is not in the path of a single call. There is no address here to send one to, and a panel that pretended otherwise would be showing you an answer we made up. Install it and call it from your own client — the Installation tab has the entry for each one.
What it does
Read Buttondown subscribers, emails, analytics and automations; add subscribers; write email drafts.
Quickstart
# 1 — add it to Claude Code
claude mcp add --scope user --transport http buttondown-mcp-by-usefulapi https://buttondown.usefulapi.io/mcp
# 2 — ask your agent for something these tools do
# buttondown_get_account, buttondown_list_newsletters, buttondown_get_newsletter and 22 more
Buttondown MCP by usefulapi costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.
Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.
Where are you running it?
Every route below installs the same thing and ends at the same approval screen. Nothing here runs on your machine and nothing runs on ours: this server answers at its publisher’s own address, and what you install is the connection straight to it.
This is a public server: it answers at its publisher’s own address and this marketplace is not in the path. Claude Code registers it in one command; --scope user makes it available in every project. The transport below is http, as the publisher's own manifest declares it.
claude mcp add --scope user --transport http buttondown-mcp-by-usefulapi https://buttondown.usefulapi.io/mcpReconnect, or start a new session, and the tools appear in the model’s tool list.
One config entry pointing straight at the publisher’s own address — this marketplace is not in the path, and nothing from this listing executes on your machine.
25 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.
Tool surface
What the model actually sees. Descriptions are diffed on every release — see version history.
The Buttondown account this API key belongs to: username and e-mail address. GET /accounts/me.
No parameter schema on file.
List the newsletters on the account with name, username, domains, sender, locale and timezone. The newsletter's API key, custom CSS and e-mail templates are never returned. GET /newsletters.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
One newsletter by id (settings and identity only; no API key, CSS or templates). GET /newsletters/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| newsletter_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
List or search subscribers (newest first by default) with e-mail, type (regular, unactivated, unsubscribed, premium, ...), tags, notes, metadata, source, open/click rates and dates. Filter by e-mail text, type, tag, signup date or domain. GET /subscribers.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| email_address | string | no | Only subscribers whose e-mail address contains this text. |
| type | array | no | Only subscribers of these types (e.g. regular, unactivated, unsubscribed). |
| not_type | array | no | Exclude subscribers of these types. |
| tag | array | no | Only subscribers with these tag names. |
| domain | array | no | Only subscribers whose e-mail domain is one of these. |
| created_after | string | no | Only subscribers created on or after this date (yyyy-mm-dd). |
| created_before | string | no | Only subscribers created before this date (yyyy-mm-dd). |
| ordering | string | no | Sort field, - for descending (default -creation_date). |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
One subscriber by id or by e-mail address: type, tags, notes, metadata, source, engagement and lifecycle dates. GET /subscribers/{id_or_email}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id_or_email | string | yes | The subscriber's id or e-mail address. |
WRITE: add ONE subscriber by e-mail address. No subscriber type is set, so Buttondown applies the newsletter's normal sign-up rules (double opt-in: the subscriber is typically created as unactivated and Buttondown e-mails THAT ONE address a confirmation message; opt-in is never bypassed, nor is the firewall). Only add people who asked to subscribe. Creating a subscriber (and its tags) can also sta
| Parameter | Type | Required | Notes |
|---|---|---|---|
| email_address | string | yes | The new subscriber's e-mail address. They receive the confirmation e-mail. |
| tags | array | no | Tag names to apply. |
| notes | string | no | Private note (never shown to the subscriber). |
| metadata | object | no | Free-form key-value data stored on the subscriber. |
| referrer_url | string | no | Where the subscriber came from. |
| utm_source | string | no | — |
| utm_medium | string | no | — |
| utm_campaign | string | no | — |
WRITE: change ONE subscriber's tags, private note or metadata. Tags are merged (add_tags / remove_tags change only those names; the others stay). A given note or metadata replaces the existing value (destructive for that field). The subscriber's type (unsubscribe, block, ...) and e-mail address cannot be changed here, and this tool sends nothing itself; but a tag, note or metadata change can start
| Parameter | Type | Required | Notes |
|---|---|---|---|
| id_or_email | string | yes | The subscriber's id or e-mail address. |
| add_tags | array | no | Tag names to add. |
| remove_tags | array | no | Tag names to remove. |
| notes | string | no | Replace the private note with this text (empty string clears it). |
| metadata | object | no | Replace the subscriber's metadata object with this one. |
List emails (drafts, scheduled and sent), newest first by default, with subject, status, publish date, slug, archive URL and analytics summary. The body is left out unless include_body is set. Filter by status, subject text or date. GET /emails.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | array | no | Only emails with these statuses (draft, scheduled, sent, ...). |
| subject | string | no | Only emails whose subject contains this text. |
| created_after | string | no | Only emails created on or after this date (yyyy-mm-dd). |
| created_before | string | no | Only emails created before this date (yyyy-mm-dd). |
| published_after | string | no | Only emails published on or after this date (yyyy-mm-dd). |
| published_before | string | no | Only emails published before this date (yyyy-mm-dd). |
| ordering | string | no | Sort order (default -creation_date). |
| include_body | boolean | no | Include each email's full body (large). Default false. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
One email by id with its full body, subject, status, publish date, slug, archive settings and analytics summary. GET /emails/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| email_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
Delivery and engagement numbers for one sent email: recipients, deliveries, opens, clicks, failures, unsubscriptions, complaints, replies, page views. GET /emails/{id}/analytics.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| email_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
WRITE: create a DRAFT email (status always "draft"). Nothing is sent or scheduled and no subscriber is e-mailed; to send it, the user must open the draft in Buttondown and send it there. This server has no tool that sends or schedules email. Body is Markdown or HTML. POST /emails.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| subject | string | yes | Subject line. |
| body | string | no | Email body in Markdown (or HTML). |
| description | string | no | Short description used for archives and SEO. |
| slug | string | no | Archive URL slug. |
| canonical_url | string | no | URL of the original source of the content. |
| image | string | no | Preview image URL. |
WRITE: edit the subject, body, description, slug or preview image of an email that is still a DRAFT (replaces those fields; the previous text is lost unless Buttondown's email history is used). Refuses any email that is not a draft, and never changes status or publish date, so nothing is sent or scheduled. PATCH /emails/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| email_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
| subject | string | no | — |
| body | string | no | New body in Markdown (or HTML); replaces the whole body. |
| description | string | no | — |
| slug | string | no | — |
| canonical_url | string | no | — |
| image | string | no | — |
List subscriber tags with name, color, descriptions and whether subscribers can edit them. GET /tags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
Subscribers created, open rate and click rate for one tag. GET /tags/{id}/analytics.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| tag_id | string | yes | Tag id (see buttondown_list_tags). |
WRITE: create a subscriber tag (needs a Buttondown plan with tags). An existing tag with the same name is returned as an error and not changed. POST /tags.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| name | string | yes | Tag name (up to 100 characters). |
| color | string | yes | Hex color, e.g. #FFD700. |
| description | string | no | Internal description (only you see it). |
| public_description | string | no | Public description shown in the subscriber portal. |
| subscriber_editable | boolean | no | Let subscribers add/remove this tag themselves. Default false. |
List automations (welcome sequences and other triggered e-mails) with name, status, trigger, actions and filters (webhook URLs in actions are shown by host only). Read-only: automations are not started or changed. GET /automations.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
One automation by id with its trigger, actions and filters. GET /automations/{id}.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| automation_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
Performance numbers for one automation. GET /automations/{id}/analytics.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| automation_id | string | yes | The object's Buttondown id (a UUID or a prefixed id such as em_..., sub_..., tag_...). |
List surveys with question, answers, status and response count. GET /surveys.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| status | string | no | Only surveys with this status. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List survey responses (who answered what), optionally for one survey, email or subscriber. GET /survey_responses.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| survey_id | string | no | Only responses to this survey. |
| email_id | string | no | Only responses submitted from this email. |
| subscriber_id | string | no | Only responses by this subscriber (id, not e-mail). |
| created_after | string | no | A date, yyyy-mm-dd. |
| created_before | string | no | A date, yyyy-mm-dd. |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List saved subscriber segments with name, description and filters. GET /segments.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List sign-up forms with title, slug, status, tags and subscriber counts. GET /forms.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List reusable content snippets with identifier, name, mode and how often each is referenced. GET /snippets.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List configured webhooks with status and subscribed event types. The signing key is never returned and the URL is shown by host only. GET /webhooks.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
List delivery events (delivered, opened, clicked, bounced, unsubscribed, ...), newest first, optionally for one email or subscriber. GET /events.
| Parameter | Type | Required | Notes |
|---|---|---|---|
| event_type | string | no | Only events of this type. |
| email_id | string | no | Only events for this email. |
| subscriber_id | string | no | Only events for this subscriber (id, not e-mail). |
| page_size | integer | no | Results per page, 1-500 (default 100). |
| page | integer | no | Page number, from 1 (default 1). Pass the previous reply's next_page. |
- Every tool — any call limit is its publisher’s, not ours
- No card, and mcprush charges nothing for it
- Runs at its publisher’s own address — this marketplace is not in the path
- Nothing to cap, because mcprush bills nothing
What counts against your monthly calls
| Tool | Unit | Calls used | Out of the allowance |
|---|
Nothing here is billable: mcprush charges nothing to install Buttondown MCP by usefulapi or to call it, at any volume.
Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.
This listing is an address its publisher runs, and you connect to it directly — this marketplace is not in the path. The scanner reads packages and public source, and an address is neither: the repository linked on this page is where this record was collected from, not a copy of what the address serves, so it is not graded in its place. So there is no grade — not a withheld one, an unmeasured one.
Release history
This is an address its publisher runs: which release it serves is theirs to choose, so there is nothing here to pin. The history below is for reading; the current release on file is 1.0.0.
No release note was published with this version.
One review per account, from a signed-in account that does not publish this listing. Nothing else is asked — you can say what you think before you install it. Publishers can reply once per review, and a review can be edited or deleted by whoever wrote it.
Any signed-in account that does not publish Buttondown MCP by usefulapi can review it, once — before installing it or after. A review from an account that has installed it is marked as one.
Nobody has reviewed this listing. The rating on the card is the mean of the reviews written here and nothing else, so there is no rating until somebody writes the first — which takes a signed-in account that does not publish it, and nothing else.