Skip to content
Agentmart
Submit a tool

addy.io

Manage addy.io email aliases, recipients, domains, rules and blocklist.

Connector by Former-Stranger · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)
Write a review

Chalk Labs

Need help deploying addy.io?

Chalk Labs sets up agents like this inside real teams: connected to your tools, tested on your data, with a human in the loop where it matters.

Book a call

Install

Works with Claude Code, Codex, VS Code, Claude Desktop, Cursor, Windsurf. Read the repository before you give any tool access to your data.

npx agentmarket install connector/former-stranger-addy-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Manage addy.io email aliases, recipients, domains, rules and blocklist.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools
21 read · 30 write · 9 delete · 2 not yet classified
Secrets
2 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Python package

Tools by what they do 62

Read from the source code; the running server may list different tools.

Read 21 · Look things up without changing anything.

  • check_domain_sending_records
  • get_account_details
  • get_account_notifications
  • get_alias
  • get_api_token_details
  • get_app_version
  • get_domain
  • get_domain_options
  • get_failed_delivery
  • get_label
  • get_recipient
  • get_rule
Show 9 more tools
  • get_username
  • list_aliases
  • list_blocklist
  • list_domains
  • list_failed_deliveries
  • list_labels
  • list_recipients
  • list_rules
  • list_usernames

Write 30 · Create, change, send or run things.

  • add_recipient_public_key
  • add_to_blocklist
  • bulk_alias_action
  • bulk_set_alias_labels
  • bulk_set_alias_recipients
  • create_alias
  • create_domain
  • create_label
  • create_recipient
  • create_rule
  • create_username
  • download_failed_delivery
Show 18 more tools
  • reorder_rules
  • resend_failed_delivery
  • restore_alias
  • set_alias_labels
  • set_alias_option
  • set_alias_recipients
  • set_domain_default_recipient
  • set_domain_option
  • set_recipient_option
  • set_rule_active
  • set_username_default_recipient
  • set_username_option
  • update_alias
  • update_domain
  • update_label
  • update_recipient
  • update_rule
  • update_username

Delete 9 · Delete, drop, revoke or wipe things.

  • delete_alias
  • delete_domain
  • delete_failed_deliveries
  • delete_label
  • delete_recipient
  • delete_rule
  • delete_username
  • remove_from_blocklist
  • remove_recipient_public_key

Not yet classified 2 · We could not tell from the name and description.

  • forget_alias
  • resend_recipient_verification

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • ADDY_API_KEY
  • ADDY_API_KEY_FILE

Other settings (environment variables or headers).

  • ADDY_BASE_URL
  • ADDY_READ_ONLY

Network hosts it talks to 4

  • addy.io · found in code
  • app.addy.io · found in code
  • github.com · found in install command, code
  • raw.githubusercontent.com · found in code

Tools (62)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • add_recipient_public_key

    Add a public GPG key to a recipient so forwarded mail can be encrypted.

  • add_to_blocklist

    Block mail from sender email addresses or whole domains, across all aliases.

  • bulk_alias_action

    Apply one action to up to 25 aliases at once (or fetch them with action='get').

  • bulk_set_alias_labels

    Replace the labels of up to 25 aliases at once.

  • bulk_set_alias_recipients

    Replace the recipients of up to 25 aliases at once.

  • check_domain_sending_records

    Check a custom domain's DNS records (SPF, DKIM, DMARC, ...) for sending/replying from aliases.

  • create_alias

    Create a new alias. Use get_domain_options to see which domains are available.

  • create_domain

    Add a custom domain. Its DNS must already have the TXT verification record addy.io shows in its dashboard.

  • create_label

    Create a label for organising aliases.

  • create_recipient

    Add a new recipient. addy.io emails it a verification link; it can't be used until verified.

  • create_rule

    Create a rule that runs actions on emails matching conditions. Example: block newsletters to a specific alias -> conditions=[{type:'alias', match:'is exactly', values:['shop@anonaddy.me']}, {type:'header', match:'exists', values:['List-Unsubscribe']}], actions=[{type:'block'}].

  • create_username

    Create an additional username (counts against the plan's username limit).

  • delete_alias

    Delete an alias. It stops receiving mail but can be brought back with restore_alias.

  • delete_domain

    Delete a custom domain. Its aliases stop working.

  • delete_failed_deliveries

    Delete failed delivery records (and any stored email).

Show 47 more tools
  • delete_label

    Delete a label (aliases are kept, just unlabelled).

  • delete_recipient

    Delete a recipient. Aliases that used it fall back to the default recipient.

  • delete_rule

    Delete a rule.

  • delete_username

    Delete a username. Its aliases stop working.

  • download_failed_delivery

    Download the raw email (.eml source) of a failed delivery, if addy.io stored it.

  • forget_alias

    PERMANENTLY forget an alias: it is disassociated from the account and cannot be restored.

  • get_account_details

    Get account details: username, plan/subscription, bandwidth used, default alias domain/format, limits, etc.

  • get_account_notifications

    Get account notifications/announcements from addy.io.

  • get_alias

    Get a single alias, including its recipients, labels and statistics.

  • get_api_token_details

    Get the name, creation date and expiry of the API token this server is using.

  • get_app_version

    Get the addy.io app version (only available on self-hosted instances).

  • get_domain

    Get a single custom domain and its settings/verification status.

  • get_domain_options

    Get the domains available for creating aliases, plus the account's default alias domain and format.

  • get_failed_delivery

    Get details of a failed delivery (sender, alias, bounce reason, ...).

  • get_label

    Get a single label.

  • get_recipient

    Get a single recipient and its settings.

  • get_rule

    Get a single rule with its conditions and actions.

  • get_username

    Get a single username and its settings.

  • list_aliases

    List or search aliases. Results are paginated; the response includes `meta` with totals and page counts.

  • list_blocklist

    List blocked senders/domains, with how many emails each has blocked.

  • list_domains

    List the custom domains connected to the account.

  • list_failed_deliveries

    List emails that addy.io failed to deliver (or quarantined).

  • list_labels

    List the labels used to organise aliases.

  • list_recipients

    List the account's recipients (the real mailboxes aliases forward to).

  • list_rules

    List all rules, in the order they are applied.

  • list_usernames

    List the account's usernames (each gives a subdomain like name.anonaddy.com for on-the-fly aliases).

  • remove_from_blocklist

    Unblock blocklist entries by id (see list_blocklist).

  • remove_recipient_public_key

    Remove a recipient's public GPG key (this also turns off encryption for it).

  • reorder_rules

    Set the order rules are applied in.

  • resend_failed_delivery

    Retry delivering a failed or quarantined email.

  • resend_recipient_verification

    Resend the verification email for an unverified recipient.

  • restore_alias

    Restore a deleted alias.

  • set_alias_labels

    Replace the labels attached to an alias.

  • set_alias_option

    Turn an alias option on or off (activate/deactivate, pin/unpin, limit reply/send to attached recipients).

  • set_alias_recipients

    Replace the set of recipients an alias forwards to.

  • set_domain_default_recipient

    Set (or clear) the default recipient for aliases on a custom domain.

  • set_domain_option

    Turn a custom domain option on or off.

  • set_recipient_option

    Turn a recipient option on or off.

  • set_rule_active

    Activate or deactivate a rule.

  • set_username_default_recipient

    Set (or clear) the default recipient for aliases on a username.

  • set_username_option

    Turn a username option on or off.

  • update_alias

    Update an alias's description, from name, or labels. Only the fields you pass are changed.

  • update_domain

    Update a custom domain's description, from name, or auto-create regex.

  • update_label

    Rename a label or change its colour.

  • update_recipient

    Set a recipient's description.

  • update_rule

    Update a rule. Only the fields you pass change; the rest are kept from the current rule.

  • update_username

    Update a username's description, from name, or auto-create regex.

Signals

Stars
0
Forks
0
Open issues
1
Weekly downloads
68
Last commit
Oct 14, 2026 (17 days ago)
Last release
Oct 14, 2026 (17 days ago)
Last package publish
Oct 14, 2026 (17 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.Former-Stranger/addy-mcp
Version
0.1.2
Auth
API key
Packages
pypi addy-mcpmcpb https://github.com/Former-Stranger/addy-mcp/releases/download/v0.1.2/addy-mcp-0.1.2.mcpb
License
MIT
Repository
github.com/Former-Stranger/addy-mcp
Website
github.com/Former-Stranger/addy-mcp
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

Done for you

Rather not set it up yourself?

Chalk Labs scopes, builds and runs agents for your team: the task audit, the eval harness, the integrations and the weekly ops report. Fixed scope, priced before we start.

See how we build AI agents →Read the case studies

Chalk Labs is a two-founder AI and growth studio. We build AI agents, CRMs and MVPs for Web3 and AI companies, and have shipped 50+ product and token launches.

launches shipped
50+
launches shipped
media placements
500+
media placements
founders on every account
2
founders on every account

Press we've placed: Forbes · CoinDesk · Decrypt · Cointelegraph · The Block

Rahil Jain, Co-founder, Chalk Labs. Ex-Goldman Sachs engineer. You talk to the person who builds it.

Get addy.io running in your business

Tell us what you want to automate. A founder replies within one working day with a plan, not a pitch deck.

Goes to the Chalk Labs founders, not the newsletter. Privacy

Need help deploying addy.io?

CallGet help
Cite this page

addy.io MCP server. Agent Mart. https://agentmart.dev/connectors/former-stranger-addy-mcp (last updated 2026-10-24)