AI 어시스턴트가 SendGrid의 Web API v3를 통해 이메일을 보내고 연락처를 관리할 수 있게 해주는 Python MCP(Model Context Protocol) 서버입니다.
도구 | 설명 |
| 하나 이상의 수신자에게 일반/HTML 이메일 보내기 |
| 동적 템플릿의 구조 검사 |
| 대체 데이터로 동적 템플릿을 통해 보내기 |
| 마케팅 연락처 추가/업데이트(SendGrid가 비동기적으로 처리) |
| 제한된 SGQL 쿼리로 연락처 검색 |
| 이름이 지정된 마케팅 연락처 목록 나열 |
| 새 발신 도메인에 대한 Domain Authentication 시작, 추가할 DNS 레코드 반환 |
| 도메인 및 해당 검증 상태 나열 |
| 레코드 추가 후 DNS 재확인 |
| Domain Authentication 제거 |
Related MCP server: sendcraft-mcp
가상 환경을 만들고 종속성을 설치합니다:
python -m venv venv
source venv/bin/activate # Windows: venv\Scripts\activate
pip install -r requirements.txt.env.example을 .env로 복사하고 SendGrid API 키(SendGrid 대시보드의 Settings > API Keys)와 기본 발신자를 입력합니다:
cp .env.example .env전송 전에 SendGrid의 Settings > Sender Authentication에서 발신자 이메일을 인증하세요 -- 인증되지 않은 발신자는 거부됩니다.
(선택 사항) Email API > Dynamic Templates에서 동적 템플릿을 만들고 .env에 DEFAULT_TEMPLATE_ID를 설정합니다.
python main.py이 명령은 Claude Desktop과 같은 MCP 클라이언트가 로컬 하위 프로세스에 대해 기대하는 전송 방식인 stdio를 통해 서버를 실행합니다.
python smoke_test.py등록된 도구를 나열하고 SendGrid 계정에 대해 실시간 호출을 한 번 수행합니다. 대화형 스키마/도구 검사를 위해서는:
npx @modelcontextprotocol/inspector python main.pyclaude_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 출력을 확인합니다.
This server cannot be deployed
Send email, manage domains, templates, webhooks and broadcasts from your AI agent.
Send, track, and manage transactional and bulk email delivery
Send transactional emails for AI agents via SMTP. Templates included.
Let AI agents send email from your own Gmail, Microsoft 365 or SMTP inbox, with guardrails.
