SendGrid MCP Server

Un servidor Python MCP (Model Context Protocol) que permite a un asistente de IA enviar correos electrónicos y gestionar contactos a través de la Web API v3 de SendGrid.

Herramientas

Configuración

1. Crea un entorno virtual e instala las dependencias:

   python -m venv venv
   source venv/bin/activate   # Windows: venv\Scripts\activate
   pip install -r requirements.txt

2. Copia .env.example a .env y completa tu clave de API de SendGrid (Settings > API Keys en el panel de SendGrid) y el remitente por defecto:

   cp .env.example .env

3. Verifica tu correo de remitente en Settings > Sender Authentication en SendGrid antes de enviar; los remitentes no verificados serán rechazados.

4. (Opcional) Crea una plantilla dinámica en Email API > Dynamic Templates y establece DEFAULT_TEMPLATE_ID en .env.

Ejecución

python main.py

Esto ejecuta el servidor a través de stdio, el transporte que los clientes MCP como Claude Desktop esperan para un subproceso local.

Verificar que funciona

python smoke_test.py

Enumera las herramientas registradas y hace una llamada real a tu cuenta de SendGrid. Para inspeccionar interactivamente el esquema y las herramientas:

npx @modelcontextprotocol/inspector python main.py

Conexión con Claude Desktop

Añade lo siguiente a claude_desktop_config.json:

{
  "mcpServers": {
    "sendgrid-mcp": {
      "command": "python",
      "args": ["/path/to/twilio-sendgrid-mcp/main.py"],
      "cwd": "/path/to/twilio-sendgrid-mcp",
      "env": {
        "SENDGRID_API_KEY": "SG.your-actual-api-key-here"
      }
    }
  }
}

Reinicia Claude Desktop después. Si falla una llamada a una herramienta, consulta ~/Library/Logs/Claude/mcp*.log (macOS) para ver la salida de stderr del servidor.