addy.io

Name: addy.io
Author: Former-Stranger

by Former-Strangerversion 0.1.2i★ –iRuns on your computer

Registry nameio.github.Former-Stranger/addy-mcp

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Chat & email
You need to fill in: ADDY_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: ADDY_API_KEY, ADDY_API_KEY_FILE, ADDY_READ_ONLY, ADDY_BASE_URL

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Download the maker’s .mcpb file

The link goes to the maker’s own file; we do not host or repackage it. Open the file and Claude Desktop installs it.

Run this in your terminal

claude mcp add addy --env ADDY_API_KEY=your-value --env ADDY_API_KEY_FILE=your-value --env ADDY_READ_ONLY=your-value --env ADDY_BASE_URL=your-value -- uvx addy-mcp

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "addy": {
      "command": "uvx",
      "args": [
        "addy-mcp"
      ],
      "env": {
        "ADDY_API_KEY": "your-value",
        "ADDY_API_KEY_FILE": "your-value",
        "ADDY_READ_ONLY": "your-value",
        "ADDY_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "addy": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "addy-mcp"
      ],
      "env": {
        "ADDY_API_KEY": "your-value",
        "ADDY_API_KEY_FILE": "your-value",
        "ADDY_READ_ONLY": "your-value",
        "ADDY_BASE_URL": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

ADDY_API_KEY secret required env
Your addy.io API key (create one at https://app.addy.io/settings/api). Alternatively set ADDY_API_KEY_FILE.
ADDY_API_KEY_FILE env
Path to a file containing the API key; takes precedence over ADDY_API_KEY
ADDY_READ_ONLY env
Set to true to hide every tool that can change your account
ADDY_BASE_URL env
Base URL for a self-hosted addy.io instance

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account Former-Stranger, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Chat & emaili

More stars than 0% of the other 1783 servers in this category
Published to the registry more recently than 53% of the other 1783 servers in this category
Basic checks equal to or better than 100% of the other 1783 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is addy.io safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: ADDY_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.1.2) reached the registry 24 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv), MCPB on your computer.

What can I use instead?

In the same category: Vexa, emailmd, MCP WhatsApp Cloud

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Vexa

by Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Runs in the cloud★ 2,949Apache-2.0Updated 2 months ago

Install

emailmd

by anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computer or cloud★ 1,385MITUpdated 31 days ago

Install

MCP WhatsApp Cloud

by codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Runs on your computer★ 277MITUpdated 5 months ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

addy-mcp

An MCP server that lets Claude (and other MCP clients) manage your addy.io account: aliases, recipients, usernames, custom domains, labels, rules, the blocklist and failed deliveries. It covers the full addy.io API.

Unofficial. This project is not affiliated with or endorsed by addy.io.

It runs on your own computer with your own API key. Nothing is hosted, and your key is only ever sent to addy.io.

1. Create an API key

In addy.io go to Settings → API Keys (https://app.addy.io/settings/api) and click Create New API Key. Consider giving it a name like "Claude" and an expiry date.

2. Install

Claude Desktop (easiest)

Download the latest addy-mcp- .mcpb from the Releases page.
Double-click it (or drag it into Settings → Extensions in Claude Desktop) and click Install.
Paste your API key when asked. Claude Desktop stores it encrypted.

Claude Desktop (manual config)

Requires uv. Open Settings → Developer → Edit Config and add:

"mcpServers": { "addy": { "command": "uvx", "args": ["addy-mcp@latest"], "env": { "ADDY_API_KEY": "paste-your-api-key-here" } } } }

Then fully quit and reopen Claude Desktop. If it can't find uvx, replace "uvx" with the full path from which uvx (macOS/Linux) or where uvx (Windows). Desktop apps don't always see your shell's PATH.

Claude Code

claude mcp add addy --scope user --env ADDY_API_KEY=paste-your-api-key-here -- uvx addy-mcp@latest

This makes the server available in Claude Code (the CLI and the desktop app's Code tab). Claude Desktop's chat uses a separate config, set up above.

Other MCP clients

Run uvx addy-mcp@latest as a stdio server with ADDY_API_KEY set in its environment.

@latest makes uvx check PyPI for a new release each time the server starts. Leave it off and uvx keeps using whichever version it first downloaded. To stay on a specific version instead, use e.g. addy-mcp==0.1.1.

Configuration

Environment variable	Required	Description
`ADDY_API_KEY`	Yes*	Your addy.io API key.
`ADDY_API_KEY_FILE`	No	Path to a file containing the key, instead of `ADDY_API_KEY`. Takes precedence if both are set. *One of the two is required.
`ADDY_READ_ONLY`	No	Set to `true` to hide every tool that can change your account. Claude can then only look things up.
`ADDY_BASE_URL`	No	For self-hosted addy.io instances, e.g. `https://addy.example.com`. Defaults to `https://app.addy.io`.

Storing your key securely

The setup above keeps the key in plain text in your MCP client's config file. That's the usual approach for local MCP servers, but you can do better:

Claude Desktop extension: the .mcpb install stores the key encrypted. Nothing else to do.
macOS Keychain (Claude Code and other clients): keep the key in the Keychain and fetch it only when the server starts, so it's never written to a config file. Add the key (you'll be prompted for it, so it doesn't end up in your shell history):

  security add-generic-password -a "$USER" -s addy-mcp -w

Then add the server with a small wrapper instead of --env:

  claude mcp add addy --scope user -- /bin/sh -c 'ADDY_API_KEY="$(security find-generic-password -a "$USER" -s addy-mcp -w)" || exit 1; export ADDY_API_KEY; exec uvx addy-mcp@latest'

If the server fails to start because uvx isn't found, replace uvx with its full path from which uvx.

On Linux, the same pattern works with secret-tool store --label=addy-mcp service addy-mcp and secret-tool lookup service addy-mcp. With 1Password, use op read "op:// / /credential" in place of the security command.

Key file: set ADDY_API_KEY_FILE to a file that only you can read (chmod 600), or to a Docker or Kubernetes secret mount.
VS Code: let VS Code prompt for the key and keep it in its secret storage:

"inputs": [ { "type": "promptString", "id": "addy-api-key", "description": "addy.io API key", "password": true } ], "servers": { "addy": { "type": "stdio", "command": "uvx", "args": ["addy-mcp@latest"], "env": { "ADDY_API_KEY": "${input:addy-api-key}" } } } }

Whichever you choose, use a separate addy.io key for each app or device, so you can revoke one without breaking the others, and give it an expiry date.

Updating

Installed with `addy-mcp@latest` (the commands above): restart Claude (or your MCP client) and the newest release is picked up automatically.
Installed with plain `uvx addy-mcp`: uvx keeps using the version it first downloaded. Change addy-mcp to addy-mcp@latest in your config and restart Claude.
Claude Desktop extension (`.mcpb`): download the new .mcpb from the Releases page and install it the same way. Your API key and settings are kept, so you won't be asked for them again.

To see which version is newest, run uvx addy-mcp@latest --version (available from 0.1.1). To hear about new releases, watch the repo on GitHub (Watch → Custom → Releases). Changes are listed in the changelog.

What you can ask

"Make me a new alias for my Netflix account."
"Which of my aliases have blocked the most emails? Deactivate the top 5."
"Find every alias I created for shopping sites and label them 'Shopping'."
"Block everything from marketing.example.com."
"Create a rule that blocks newsletters (List-Unsubscribe header) sent to my shop@ alias."
"Why did mail to my bank alias fail last week?"

Tools

Area	Tools
Account	`get_account_details`, `get_api_token_details`, `get_account_notifications`, `get_domain_options`, `get_app_version`
Aliases	`list_aliases`, `get_alias`, `create_alias`, `update_alias`, `delete_alias`, `restore_alias`, `forget_alias`, `set_alias_option` (active / pinned / attached-recipients-only), `set_alias_recipients`, `set_alias_labels`
Bulk aliases	`bulk_alias_action` (get / activate / deactivate / pin / unpin / delete / restore / forget), `bulk_set_alias_recipients`, `bulk_set_alias_labels`
Recipients	`list_recipients`, `get_recipient`, `create_recipient`, `update_recipient`, `delete_recipient`, `resend_recipient_verification`, `add_recipient_public_key`, `remove_recipient_public_key`, `set_recipient_option` (active / can reply-send / encryption / inline encryption / protected headers / strip PGP keys / strip PGP signatures)
Usernames	`list_usernames`, `get_username`, `create_username`, `update_username`, `delete_username`, `set_username_default_recipient`, `set_username_option` (active / catch-all / can login)
Domains	`list_domains`, `get_domain`, `create_domain`, `update_domain`, `delete_domain`, `set_domain_default_recipient`, `check_domain_sending_records`, `set_domain_option` (active / catch-all / shared with family)
Labels	`list_labels`, `get_label`, `create_label`, `update_label`, `delete_label`
Rules	`list_rules`, `get_rule`, `create_rule`, `update_rule`, `delete_rule`, `reorder_rules`, `set_rule_active`
Blocklist	`list_blocklist`, `add_to_blocklist`, `remove_from_blocklist`
Failed deliveries	`list_failed_deliveries`, `get_failed_delivery`, `download_failed_delivery`, `resend_failed_delivery`, `delete_failed_deliveries`

Every tool is labelled read-only, write, or destructive (MCP tool annotations), so clients like Claude can ask before running anything risky. Deleting an alias can be undone with restore_alias. Forgetting an alias is permanent.

Privacy and security

The server runs locally and talks only to addy.io (or your ADDY_BASE_URL). It has no telemetry.
Your API key gives full access to your addy.io account. Use a dedicated key so you can revoke it on its own, and turn on ADDY_READ_ONLY if you only want Claude to look things up.
Anything the tools return (alias addresses, descriptions, failed-delivery emails) is passed to your AI client, and is subject to that client's privacy policy.

Development

git clone https://github.com/Former-Stranger/addy-mcp

cd addy-mcp uv run --no-editable python -m pytest # unit tests (mocked HTTP, never touch a real account) uv run ruff check && uv run ruff format --check

scripts/live_test.py exercises the server against a real account: it creates, updates, deletes, restores and finally forgets a throwaway alias and label. Run it with ADDY_API_KEY=... uv run --no-editable python scripts/live_test.py --yes.

--no-editable: on some macOS setups files in .venv get the "hidden" flag, and Python 3.13+ ignores hidden .pth files, which breaks editable installs. A regular install sidesteps that.

Releasing

Bump version in pyproject.toml, run uv run python scripts/sync_metadata.py, and update CHANGELOG.md.
Commit, then tag and push: git tag v0.2.0 && git push origin v0.2.0.
Approve the pypi deployment when GitHub asks (the release pauses until a maintainer approves it).

The release workflow publishes to PyPI, attaches the .mcpb bundle to a GitHub release, and updates the MCP Registry listing.

A weekly workflow compares the addy.io API docs with scripts/addy_api_snapshot.txt and opens an issue when the API changes. After updating the tools, refresh the snapshot with python3 scripts/check_api_docs.py --update. Dependabot opens weekly pull requests for dependency and GitHub Actions updates.

License

MIT

addy.io

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Chat & emaili

Common questions

Alternatives

Vexa

emailmd

MCP WhatsApp Cloud

README from the maker

addy-mcp

1. Create an API key

2. Install

Claude Desktop (easiest)

Claude Desktop (manual config)

Claude Code

Other MCP clients

Configuration

Storing your key securely

Updating

What you can ask

Tools

Privacy and security

Development

Releasing

License