SendGrid MCP Server

Сервер Python MCP (Model Context Protocol), который позволяет ИИ-ассистенту отправлять электронные письма и управлять контактами через Web API v3 сервиса SendGrid.

Tools

Setup

1. Создайте виртуальное окружение и установите зависимости:

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

2. Скопируйте .env.example в .env и укажите ваш API-ключ SendGrid (Settings > API Keys в панели управления SendGrid) и отправителя по умолчанию:

   cp .env.example .env

3. Проверьте ваш адрес отправителя в разделе Settings > Sender Authentication в SendGrid перед отправкой — непроверенные отправители будут отклонены.

4. (Необязательно) Создайте динамический шаблон в разделе Email API > Dynamic Templates и укажите DEFAULT_TEMPLATE_ID в .env.

Running

python main.py

Это запускает сервер через stdio — транспорт, который ожидают MCP-клиенты, такие как Claude Desktop, для локального подпроцесса.

Verifying it works

python smoke_test.py

Выводит список зарегистрированных инструментов и выполняет один реальный вызов к вашему аккаунту SendGrid. Для интерактивного просмотра схемы/инструментов:

npx @modelcontextprotocol/inspector python main.py

Connecting to Claude Desktop

Добавьте в 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"
      }
    }
  }
}

После этого перезапустите Claude Desktop. Если вызов инструмента завершится ошибкой, проверьте ~/Library/Logs/Claude/mcp*.log (macOS) для вывода stderr сервера.