@emailalias/mcp

Servidor MCP para la API REST de EmailAlias.io. Te permite crear, gestionar y supervisar alias de correo electrónico desde Claude Desktop, Cursor, Zed, Cline y cualquier otro asistente de IA compatible con MCP, utilizando lenguaje natural.

"Crea un nuevo alias para Substack, etiquétalo como 'newsletter'" "Desactiva el alias de amazon, estoy recibiendo spam" "Muéstrame los alias marcados por remitentes sospechosos esta semana"

El acceso a la API es una función Premium. Genera una clave de API desde Settings → API Keys en el panel de control.

Instalación

Claude Desktop

Edita tu archivo de configuración:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Agrega la entrada emailalias bajo mcpServers:

{
  "mcpServers": {
    "emailalias": {
      "command": "npx",
      "args": ["-y", "@emailalias/mcp"],
      "env": {
        "EMAILALIAS_API_KEY": "ea_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Reinicia Claude Desktop. Deberías ver un icono de enchufe 🔌 que confirma que el servidor está conectado.

Cursor, Zed, Cline y otros clientes MCP

Cada cliente compatible con MCP acepta el mismo formato. Consulta la documentación de tu cliente para conocer la ruta de configuración exacta y luego usa:

command: npx
args: -y @emailalias/mcp
env: EMAILALIAS_API_KEY=ea_live_...

Instalación global (opcional)

Si no quieres que npx descargue el paquete en cada inicio:

npm install -g @emailalias/mcp

Luego cambia command a emailalias-mcp y elimina los argumentos -y @emailalias/mcp.

Related MCP server: Inbound Email MCP Server

Configuración

Herramientas disponibles

Ejemplos de prompts (Claude Desktop)

Create a disposable alias for signing up to Substack. Label it "newsletter".

Show me all aliases that have received zero emails in 30 days.

Disable every alias labelled "shopping" and list what you disabled.

What's my exposure alert count for this month?

Desarrollo

git clone https://github.com/emailalias/emailalias-mcp.git
cd emailalias-mcp
npm install
npm run build

# Test against the MCP Inspector (installs on demand)
npx @modelcontextprotocol/inspector node dist/index.js

EMAILALIAS_API_KEY debe estar configurada en tu shell para ejecuciones manuales.

Notas de seguridad

• Tu clave de API permanece en tu máquina. Este servidor se ejecuta localmente (transporte stdio), invoca la API de EmailAlias a través de HTTPS y envía la clave directamente. Ningún tercero la ve.

• No subas claude_desktop_config.json al control de versiones — contiene tu clave. Trátalo como un archivo .env.

• El alcance importa. Cualquier herramienta MCP que tu LLM decida llamar se ejecuta contra tu cuenta real. Revisa lo que el modelo propone antes de aprobar acciones destructivas como delete_alias.

Enlaces

• Documentación de la API: https://emailalias.io/documentation

• EmailAlias.io: https://emailalias.io

• Protocolo de contexto de modelo (MCP): https://modelcontextprotocol.io

Licencia

MIT