# SendGrid MCP by usefulapi

> SendGrid MCP by usefulapi is an MCP server. Send email and read templates, marketing contacts, lists, stats, bounces and unsubscribes. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/sendgrid/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/sendgrid
- **MCP Registry name:** io.usefulapi/sendgrid
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://sendgrid.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "sendgrid": {
      "url": "https://sendgrid.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/sendgrid-mcp-by-usefulapi
