Skip to content
MCP server

SendGrid MCP by usefulapi

Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes.

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About SendGrid MCP by usefulapi

SendGrid MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://sendgrid.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sendgrid": {
      "url": "https://sendgrid.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sendgrid": {
      "type": "http",
      "url": "https://sendgrid.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sendgrid": {
      "serverUrl": "https://sendgrid.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sendgrid": {
      "type": "http",
      "url": "https://sendgrid.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (11)

Read directly from the server.

sendgrid_ping
Health check — verifies the API key works and returns the scopes (permissions) granted to it. SendGrid: GET /v3/scopes.
sendgrid_list_templates
List your transactional email templates (Dynamic and/or Legacy). Returns { result: [...], _metadata } — use _metadata.next / page_token to paginate. SendGrid: GET /v3/templates.
sendgrid_get_template
Get a single transactional email template by id, including its versions (subject + content). SendGrid: GET /v3/templates/{template_id}.
sendgrid_list_marketing_lists
List your Marketing Campaigns contact lists, each with its id, name, and contact_count. Returns { result: [...], _metadata }. SendGrid: GET /v3/marketing/lists.
sendgrid_get_contact_count
Get the total number of Marketing Campaigns contacts on your account. Returns { contact_count, billable_count }. SendGrid: GET /v3/marketing/contacts/count.
sendgrid_search_contacts_by_email
Look up marketing contacts by exact email address (a read-only lookup — mutates nothing). Returns { result: { "<email>": { contact: {...} } } }. SendGrid: POST /v3/marketing/contacts/search/emails.
sendgrid_get_stats
Get global email statistics over a date range (delivered, opens, clicks, bounces, spam reports, etc.). Returns an array of { date, stats: [{ metrics: {...} }] }. SendGrid: GET /v3/stats.
sendgrid_list_bounces
List bounced email addresses (the bounce suppression list). Returns an array of { created, email, reason, status }. SendGrid: GET /v3/suppression/bounces.
sendgrid_list_global_unsubscribes
List globally-unsubscribed email addresses (the global suppression list). Returns an array of { created, email }. SendGrid: GET /v3/suppression/unsubscribes.
sendgrid_send_mail
SENDS A REAL EMAIL immediately via SendGrid. Provide `from_email` and one or more `to` recipients, plus EITHER a subject + content OR a `template_id` (dynamic template ids start with "d-", pass values via dynamic_template_data). Returns { status: "accepted", message_id }. SendGrid: POST /v3/mail/send.
sendgrid_add_or_update_contacts
UPSERTS marketing contacts (creates new ones, updates existing ones by email) and optionally adds them to lists. This is an ASYNC job — returns { job_id } you can poll. SendGrid: PUT /v3/marketing/contacts.

SendGrid MCP by usefulapi FAQ

How do I add SendGrid MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http sendgrid https://sendgrid.usefulapi.io/mcp