Unsubscribe from real lists. Send the rest to spam.

Half the “unsubscribe” links in your inbox belong to real newsletters you forgot signing up for. The other half are traps that confirm your address is active. Give a dedicated cleanup agent its own Gmail label—co:unsubscribe-agent—and let it inspect the headers first: legitimate lists get a signed one-click unsubscribe, and shady senders go straight to spam without anyone opening a link.

Takes a minute to apply. No credit card required.

unsubscribe-agent2 threads labeled co:unsubscribe-agent

Juniper Coffee <hello@news.junipercoffee.com>

20% off your next bag, this weekend only

  • SPF, DKIM, and DMARC pass
  • Valid List-Id header (weekly.junipercoffee.com)
  • DKIM-signed RFC 8058 one-click unsubscribe

unsubscribeunsubscribed

Rewards Center <claim@rewards-center-4471.top>

Final notice: claim your $500 gift card

  • DMARC fail · no DKIM signature
  • No List-Id · footer link points to an unrelated domain
  • Body asks you to “verify your account” to opt out

mark_thread_spammoved to spam

Two threads labeled co:unsubscribe-agent. The agent unsubscribes from the verified list and reports the spoofed sender as spam—without opening a browser on either link.

The problem

Clicking “unsubscribe” on junk mail only gets you more of it.

When you want off a real mailing list, unsubscribing works. When the email is cold spam or phishing, clicking the footer link just confirms that a real person reads this address.

01

It confirms your address is live

Unsubscribe links carry a unique identifier tied to your email address. Following one on a spam message tells the sender that an active human opened the email—making your address worth sending more to.

02

Footer links open arbitrary web pages

Clicking an unsubscribe link in your browser—or letting a browser-automation bot click it for you—loads whatever page the sender hosts, logs your IP and browser fingerprint, and often asks you to “confirm” your identity.

03

The headers tell the real story

Before you ever touch a link, Gmail’s SPF, DKIM, and DMARC verdicts, the List-Id header, and the List-Unsubscribe domain reveal whether you’re dealing with a reputable bulk sender or a throwaway domain. Checking raw headers is tedious for you and instant for an agent.

How it works

Batch-label the clutter and let your agent check the headers.

  1. Create a locked-down cleanup agent

    Create an agent named unsubscribe-agent in comail. Connect Claude, ChatGPT, or your own MCP client to its URL and give it a straightforward prompt: unsubscribe from legitimate mailing lists, and mark anything suspicious as spam.

  2. Label unwanted mail in Gmail

    Apply co:unsubscribe-agent to newsletters, promotions, or junk mail in Gmail on your laptop or phone. You can select dozens of threads at once and label the whole batch in one go.

  3. Your agent inspects authentication and list headers

    A notification wakes the agent up. Calling get_message returns the sender, the List-Id and List-Unsubscribe headers, and Gmail’s own SPF, DKIM, and DMARC verification results alongside the message text.

  4. Execute a one-click POST or move to Spam

    For a verified list, the agent calls unsubscribe and comail dispatches the RFC 8058 one-click request. For anything unsigned or sketchy, the agent calls mark_thread_spam and nothing is ever sent to the sender.

unsubscribe-agent — claude

> Watch co:unsubscribe-agent. Unsubscribe from legitimate mailing lists and move anything sketchy to spam.

comail · create_notification_url

Listening for new mail · renews hourly

notification message: msg_2b81f0

comail · get_message (message_id: "msg_2b81f0")

From: Juniper Coffee <hello@news.junipercoffee.com>

List-Id: weekly.junipercoffee.com · dkim: pass · dmarc: pass

Authenticated retail newsletter with a signed one-click header. Unsubscribing.

comail · unsubscribe (message_id: "msg_2b81f0")

status: "unsubscribed"

notification message: msg_2b8a17

comail · get_message (message_id: "msg_2b8a17")

From: Rewards Center <claim@rewards-center-4471.top>

no List-Id · dkim: none · dmarc: fail

Unsigned sender failing DMARC with an off-domain opt-out link. Moving to Spam without clicking.

comail · mark_thread_spam (thread_id: "thr_2b8a17")

changed: ["msg_2b8a17"]

Guardrails

Your agent judges the sender. comail enforces the protocol.

The agent never visits URLs from an email body. It passes a message ID to comail’s unsubscribe tool, which runs strict cryptographic and network checks before making a request.

01

DKIM-signed RFC 8058 headers only

comail only sends an unsubscribe request when the message has a single https List-Unsubscribe URL and List-Unsubscribe-Post: List-Unsubscribe=One-Click, with both headers covered by a DKIM signature verified by Gmail. Otherwise unsubscribe returns not_one_click and sends nothing.

02

Server-side POST, no redirects, no IP leak

comail sends a single POST request to a public IP address and refuses to follow HTTP redirects. No webpage is loaded or rendered, so neither your browser nor your IP address ever reaches the sender’s server.

03

Immune to prompt injection in spam

Spam is untrusted input. Because this agent only sees threads you explicitly labeled for it—and has sending, trashing, and attachment reading turned off—a malicious email can’t trick it into reading your private mail, opening a file, or sending a reply.

Permissions

Scoped down to a single job.

New agents in comail start in allow-list mode with sending and trashing off. Disable attachment access—from the dashboard or via the management MCP—and the agent has only the permissions needed to clean up unwanted mail.

Inbox hygiene

unsubscribe-agent

An allow-list agent that sees nothing unless you label it co:unsubscribe-agent. It can execute one-click unsubscribes, move threads to Spam, and archive—without access to attachments, sending, or Trash.

view allow co:unsubscribe-agent
view deny default
spam allow report spam, unsubscribe
archive allow —
attachments deny filenames only
send deny drafts only
trash deny —
admin-agent — claude

> Create an unsubscribe-agent that only reads mail I label for it. Disable attachments and sending.

comail-admin · create_agent (name: "unsubscribe-agent")

Allow-list (co:unsubscribe-agent) · drafts only

comail-admin · set_agent_attachments (can_read_attachments: false)

ok

Ready: mcp.comail.io/a/3c9d02e1/unsubscribe-agent

Every new agent starts on an allow-list, drafts only, with spam and archive enabled. Turning off attachment contents is a single call.

FAQ

Common questions.

Doesn’t a one-click POST still tell the sender my address is active?

Yes, which is why the agent inspects the sender first and only calls unsubscribe on legitimate mailing lists. Reputable bulk senders are required by Gmail’s sender guidelines to support and honor RFC 8058 one-click unsubscribes; sketchy or unauthenticated senders get moved straight to Spam without any network request.

What happens if a newsletter doesn’t support one-click unsubscribe?

unsubscribe returns not_one_click (along with the list’s mailto: unsubscribe address if one is present in the header) and sends nothing. Your agent can then either move future emails to Spam or prepare an unsubscribe draft in Gmail Drafts for you to send.

Can I clean up a backlog of old newsletters at once?

Yes. Search or filter in Gmail, select a batch of threads, and apply co:unsubscribe-agent in one action. comail queues a notification for each newly labeled thread so your agent works through the batch automatically. You can also use a Gmail filter to apply the label to incoming mail automatically.

Does marking a thread as spam delete it permanently?

No. mark_thread_spam moves the thread to Gmail’s Spam folder, where you (or the agent via unmark_thread_spam) can move it back to the inbox. The agent has no Trash permission, and comail has no permanent delete tool. One limit to know: Gmail deletes anything left in Spam after 30 days, so that’s the recovery window.

Request access

We’re onboarding beta users in small batches. Tell us what you want your agent to handle; specific use cases go to the front of the line.

Clients / harnesses (optional)

Select all that apply.

We’ll only email you about the beta. No card, no newsletter.