SendGrid MCP Server

Ein Python-MCP-Server (Model Context Protocol), der es einem KI-Assistenten ermöglicht, E-Mails zu senden und Kontakte über die Web-API v3 von SendGrid zu verwalten.

Tools

Setup

1. Erstellen Sie eine virtuelle Umgebung und installieren Sie die Abhängigkeiten:

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

2. Kopieren Sie .env.example in .env und füllen Sie Ihren SendGrid-API-Schlüssel (Einstellungen > API-Schlüssel im SendGrid-Dashboard) und den Standardabsender aus:

   cp .env.example .env

3. Verifizieren Sie Ihre Absender-E-Mail unter „Einstellungen > Sender Authentication“ in SendGrid, bevor Sie senden – nicht verifizierte Absender werden abgelehnt.

4. (Optional) Erstellen Sie eine dynamische Vorlage unter Email API > Dynamic Templates und setzen Sie DEFAULT_TEMPLATE_ID in .env.

Running

python main.py

Dies führt den Server über stdio aus, den Transport, den MCP-Clients wie Claude Desktop für einen lokalen Unterprozess erwarten.

Verifying it works

python smoke_test.py

Listet die registrierten Tools auf und führt einen Live-Aufruf gegen Ihr SendGrid-Konto aus. Für interaktive Schema-/Tool-Inspektion:

npx @modelcontextprotocol/inspector python main.py

Connecting to Claude Desktop

Fügen Sie zu claude_desktop_config.json hinzu:

{
  "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"
      }
    }
  }
}

Starten Sie Claude Desktop anschließend neu. Wenn ein Tool-Aufruf fehlschlägt, prüfen Sie ~/Library/Logs/Claude/mcp*.log (macOS) auf die stderr-Ausgabe des Servers.