No install? Use cloud.anythingmcp.com directly.
Sign in, install the SendGrid in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.
TL;DR
Send transactional and marketing emails via SendGrid's v3 API from any AI agent. 14 tools covering send, templates, stats, suppressions, contacts and marketing lists. Bearer-token auth, EU + Global datacenter support.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → SendGrid, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
SendGrid + Gemini
Send transactional and marketing emails via SendGrid's v3 API from any AI agent. 14 tools covering send, templates, stats, suppressions, contacts and marketing lists. Bearer-token auth, EU + Global datacenter support.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
SENDGRID_API_KEY
Step 1 — Get credentials
Setup:
- Sign in to SendGrid (or via Twilio's console — SendGrid is part of Twilio since 2019) → Settings → API Keys → Create API Key.
- Pick Restricted Access and grant at least: Mail Send (Full Access), Template Engine (Read), Stats (Read), Suppressions (Read), Marketing > Contacts (Read+Write), Marketing > Lists (Read+Write). Full Access also works but follows least-privilege poorly.
- Copy the key — it's shown ONCE. Set
SENDGRID_API_KEYto it. - (Optional) If your account is on the EU datacenter (GDPR data residency), set
SENDGRID_BASE_URLtohttps://api.eu.sendgrid.com. Default is the globalhttps://api.sendgrid.com.
…(continued in the in-app connector instructions)
Step 2 — Install the adapter
git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
Step 3 — Add the connector in Gemini
Gemini CLI reads MCP servers from ~/.gemini/settings.json (or %APPDATA%\gemini\settings.json on Windows). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp",
"headers": { "Authorization": "Bearer YOUR_MCP_API_KEY" }
}
}
}
- Get your MCP API key from AnythingMCP → Profile → MCP API Keys → New Key.
- Save the file and restart
gemini. - Run
/mcpinside the Gemini CLI —SendGridshould be listed as available. - Vertex AI Studio: pass
https://cloud.anythingmcp.com/mcpto thetoolsarray of your request with the same Bearer header.
Available tools
| Tool | What it does |
|---|---|
sendgrid_send_mail | Send a transactional or batch email via the v3 Mail Send endpoint |
sendgrid_list_templates | List transactional templates (legacy or dynamic) on the account |
sendgrid_get_template | Fetch a single template by id, including all its versions |
sendgrid_get_stats | Get aggregated email statistics across a date range: requests, delivered, opens, unique_opens, clicks, unique_clicks, bounces, spam_reports, |
sendgrid_list_bounces | List bounced email addresses |
sendgrid_get_bounce | Get the bounce details for a specific email address (reason code, timestamp, status) |
sendgrid_list_invalid_emails | List addresses SendGrid rejected as malformed at submission time (not bounces — these never made it out) |
sendgrid_list_spam_reports | List recipients who reported your emails as spam |
sendgrid_list_marketing_contacts | List marketing contacts (NOT transactional recipients — these live in the Marketing Campaigns product) |
sendgrid_upsert_marketing_contacts | Add or update up to 30,000 marketing contacts in one PUT call |
sendgrid_get_marketing_import_job_status | Check the status of a contacts-upsert job returned by sendgrid_upsert_marketing_contacts |
sendgrid_list_marketing_lists | List all Marketing Campaigns contact lists |
sendgrid_create_marketing_list | Create a new Marketing Campaigns contact list |
sendgrid_search_marketing_contacts | Search marketing contacts using SendGrid Query Language (similar to SQL WHERE) |
FAQ
Does Gemini 1.5 Pro or 2.x support MCP? Yes — Gemini CLI ≥ 0.4 and Vertex AI tools API both accept MCP httpUrl connectors with Bearer headers.
Next steps
Was this guide helpful?