Sendgrid MCP server

Read from the package source without running it. The installed server may list more.

• add_contact

  Upsert contacts in Marketing Campaigns via PUT /marketing/contacts. Matches on email. Returns a job_id — ingestion is async. Optionally assign to list_ids.

• add_suppression

  Add recipients to a suppression group via POST /asm/groups/{group_id}/suppressions. Future mail in this group will be blocked for these addresses.

• cancel_scheduled_sendwrite action

  Cancel or pause a scheduled send by batch_id via POST /user/scheduled_sends. A send_mail call with `send_at` + `batch_id` can be aborted until the send runs. Set status to 'cancel' or 'pause'.

• create_listwrite action

  Create a Marketing Campaigns contact list via POST /marketing/lists. Returns the new list UUID. Use the id with add_contact's list_ids to populate it.

• create_templatewrite action

  Create a transactional template via POST /templates. Returns a template_id. Add versions separately via /templates/{id}/versions.

• delete_bouncewrite action

  Remove a bounced address from the bounce suppression list via DELETE /suppression/bounces/{email}. Call this after the recipient confirms the underlying issue (e.g. mailbox full) is resolved.

• delete_contactwrite action

  Delete contacts by id via DELETE /marketing/contacts?ids=.... Pass a comma-separated list of contact UUIDs, or set delete_all_contacts=true to wipe all contacts (irreversible).

• delete_listwrite action

  Delete a Marketing Campaigns contact list via DELETE /marketing/lists/{id}. Contacts are NOT deleted by default — set delete_contacts=true to also remove contacts that belong ONLY to this list.

• get_bounces

  Retrieve bounced recipients via GET /suppression/bounces. Returns [{email, created, reason, status}]. Filter by time window with start_time/end_time (Unix seconds).

• get_contact

  Retrieve a single Marketing Campaigns contact by id via GET /marketing/contacts/{id}. Returns full contact record including custom fields and list_ids.

• get_event_webhook_settings

  Retrieve the Event Webhook configuration via GET /user/webhooks/event/settings. Returns {url, enabled, delivered, open, click, bounce, dropped, spam_report, unsubscribe, ...} — useful to verify which SendGrid events are being forwarded.

• get_stats

  Global email stats via GET /stats. Returns sent/delivered/opens/clicks/bounces/spam_reports aggregated between start_date and end_date.

• list_contacts

  List Marketing Campaigns contacts via GET /marketing/contacts. Returns up to 50 sample contacts; for full export use a Contacts Export job.

• list_lists

  List all Marketing Campaigns contact lists via GET /marketing/lists. Returns list UUIDs, names, and contact_count. Supports pagination.

• list_suppressions

  List all suppressed recipients for an unsubscribe group via GET /asm/groups/{group_id}/suppressions. Returns an array of email strings.

• list_templates

  List transactional templates via GET /templates. By default returns dynamic templates (recommended); set generations='legacy' for legacy.

• list_unsubscribe_groups

  List all unsubscribe groups on the account via GET /asm/groups. Returns [{id, name, description, is_default, unsubscribes}]. Use the id with list_suppressions / add_suppression.

• search_contacts

  Search contacts with an SGQL query via POST /marketing/contacts/search. Example: `email LIKE '%@codespar.com' AND CONTAINS(list_ids, 'abc-123')`.

• send_mailwrite action

  Send an email via POST /mail/send. Supply at least one `personalization` with `to` recipients, a `from` address (falls back to SENDGRID_FROM_EMAIL), and either `content` blocks or a `template_id` with `dynamic_template_data`. Returns 202 on success.

• send_templatewrite action

  Convenience wrapper for POST /mail/send with a dynamic template. Equivalent to send_mail with `template_id` set. Supply `to`, `template_id`, and `dynamic_template_data`; content is rendered from the template.

• Code scan5 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 29 days ago15/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

82/100

higher than 70% of 916 Email servers

Tools

20

the typical Email server has 7

Tools that change things

40%

typical: 25%. Fewer write tools means less an agent can break

GitHub stars

271

more than 95% of 493 Email servers

Sendgrid: common questions

Is Sendgrid MCP server safe?

Mostly: it is graded B (82/100). Read the Sendgrid safety report

How do I install Sendgrid?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Sendgrid need an API key?

Yes. The registry entry asks for SENDGRID_API_KEY.

Is Sendgrid maintained?

The last commit was 67 days ago (2026-08-29). The latest release is v0.2.2.

What can I use instead of Sendgrid?

Servers from other publishers that do the same job: Nitrosend MCP server, SendGrid Transactional MCP server and MisarMail MCP Server. Compare all Sendgrid alternatives.

How does Sendgrid compare with other Email MCP servers?

safety score 82/100 (higher than 70% of 916 Email servers); tools 20 (the typical Email server has 7); tools that change things 40% (typical: 25%. Fewer write tools means less an agent can break). Full comparison.