addy.io MCP server

addy-mcp

<!-- mcp-name: io.github.Former-Stranger/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 () and click Create New API Key. Consider giving it a name like "Claude" and an expiry date.

2. Install

Claude Desktop (easiest)

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

Claude Desktop (manual config)

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

{
  "mcpServers": {
    "addy": {
      "command": "uvx",
      "args": ["addy-mcp"],
      "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

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 as a stdio server with ADDYAPIKEY set in its environment.

Configuration

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

Shortened. The full README is on GitHub.