addy-mcp

An unofficial MCP server that allows Claude and other Model Context Protocol clients to manage addy.io email alias accounts. It provides tools to handle aliases, recipients, usernames, custom domains, labels, rules, blocklists, and failed deliveries by interacting with the full addy.io API locally.

Package and access

Local package with source-attributed installation metadata. Koskamo does not execute packages during review.

Community listingLocal stdioSource reviewed; not executedPublished by Former-Stranger

You need:Create an API key In addy.io go to Settings → API KeysADDY_API_KEY Yes* Your addy.io API key

Vendor documentation

What you can do with it

Manage email aliases and recipients
Configure custom domains and labels
Set up rules and blocklists
View failed deliveries

Source and maintenance

Community listingRegistry 0.1.2

mcp-registry: io.github.Former-Stranger/addy-mcp@0.1.2 Source repository Project website

Maintenance checked: Nov 1, 2026, 3:42 PM UTC

Packages and installation

Source-provided package data. Koskamo has not executed or live-probed this package.

addy-mcp 0.1.2

pypiuvx

addy-mcp package definition

{
  "version": "0.1.2",
  "transport": "stdio",
  "identifier": "addy-mcp",
  "runtimeHint": "uvx",
  "registryType": "pypi",
  "environmentVariables": [
    {
      "name": "ADDY_API_KEY",
      "isRequired": true,
      "description": "Your addy.io API key (create one at https://app.addy.io/settings/api). Alternatively set ADDY_API_KEY_FILE."
    },
    {
      "name": "ADDY_API_KEY_FILE",
      "format": "filepath",
      "description": "Path to a file containing the API key; takes precedence over ADDY_API_KEY"
    },
    {
      "name": "ADDY_READ_ONLY",
      "choices": [
        "true",
        "false"
      ],
      "default": "false",
      "description": "Set to true to hide every tool that can change your account"
    },
    {
      "name": "ADDY_BASE_URL",
      "default": "https://app.addy.io",
      "description": "Base URL for a self-hosted addy.io instance"
    }
  ]
}

Tools

Reported by the attributed source; not independently observed by Koskamo.

No tool definitions available.

Connect from your client

Each snippet configures the same source-provided package; replace placeholders before use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Cursor

Merge this local stdio configuration, replace every placeholder environment value, and restart Cursor. Koskamo has not executed this package.

Cursor configuration

{
  "mcpServers": {
    "addy-mcp": {
      "command": "uvx",
      "args": [
        "addy-mcp==0.1.2"
      ],
      "env": {
        "ADDY_API_KEY": "<YOUR_ADDY_API_KEY>",
        "ADDY_API_KEY_FILE": "<YOUR_ADDY_API_KEY_FILE>",
        "ADDY_READ_ONLY": "<YOUR_ADDY_READ_ONLY>",
        "ADDY_BASE_URL": "<YOUR_ADDY_BASE_URL>"
      }
    }
  }
}

Cline

Merge this local stdio configuration, replace every placeholder environment value, and restart Cline. Koskamo has not executed this package.

Cline configuration

{
  "mcpServers": {
    "addy-mcp": {
      "command": "uvx",
      "args": [
        "addy-mcp==0.1.2"
      ],
      "env": {
        "ADDY_API_KEY": "<YOUR_ADDY_API_KEY>",
        "ADDY_API_KEY_FILE": "<YOUR_ADDY_API_KEY_FILE>",
        "ADDY_READ_ONLY": "<YOUR_ADDY_READ_ONLY>",
        "ADDY_BASE_URL": "<YOUR_ADDY_BASE_URL>"
      }
    }
  }
}

VS Code

Merge this local stdio configuration, replace every placeholder environment value, and restart VS Code. Koskamo has not executed this package.

VS Code configuration

{
  "servers": {
    "addy-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "addy-mcp==0.1.2"
      ],
      "env": {
        "ADDY_API_KEY": "<YOUR_ADDY_API_KEY>",
        "ADDY_API_KEY_FILE": "<YOUR_ADDY_API_KEY_FILE>",
        "ADDY_READ_ONLY": "<YOUR_ADDY_READ_ONLY>",
        "ADDY_BASE_URL": "<YOUR_ADDY_BASE_URL>"
      }
    }
  }
}

Claude Desktop

Merge this local stdio configuration, replace every placeholder environment value, and restart Claude Desktop. Koskamo has not executed this package.

Claude Desktop configuration

{
  "mcpServers": {
    "addy-mcp": {
      "command": "uvx",
      "args": [
        "addy-mcp==0.1.2"
      ],
      "env": {
        "ADDY_API_KEY": "<YOUR_ADDY_API_KEY>",
        "ADDY_API_KEY_FILE": "<YOUR_ADDY_API_KEY_FILE>",
        "ADDY_READ_ONLY": "<YOUR_ADDY_READ_ONLY>",
        "ADDY_BASE_URL": "<YOUR_ADDY_BASE_URL>"
      }
    }
  }
}

Let your agent find its tools

Find servers like addy-mcp from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows

See all 4,540