Mcp Sendgrid

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for SendGrid — global transactional + marketing email (Twilio-owned)

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Lets an assistant send SendGrid transactional and marketing email and manage contacts, lists, templates, suppressions, and stats.

What you can do
Wraps the SendGrid v3 API in about 20 tools. It can send mail and dynamic-template email, upsert, search, list, and delete Marketing Campaigns contacts and lists, manage transactional templates, suppression groups and bounces, cancel scheduled sends, read event webhook settings, and fetch global email stats.
When to use it
Useful when an assistant should send order confirmations, shipping updates, or promotional email, or maintain SendGrid contact lists and suppression data directly. It fits notification and marketing workflows that already run on SendGrid.
Requirements
Runs locally over stdio, typically via npx from the npm package @codespar/mcp-sendgrid, so Node.js is needed. Requires a SendGrid API key in SENDGRID_API_KEY; SENDGRID_FROM_EMAIL is an optional default sender that must be a verified sender or on an authenticated domain. Network access to api.sendgrid.com is required.
Before you install
SENDGRID_API_KEY is a secret bearer token granting account-level access; keep it out of logs and shared configs. Several tools write or delete data, including sending mail, deleting contacts and lists, removing bounces, and cancelling scheduled sends. Sending email and managing marketing contacts can incur cost or violate consent rules, so confirm recipients and content before use.

Installation

In SourceWeft

  1. Open Mcp Sendgrid in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-sendgrid

MCP server for SendGrid — global transactional and marketing email.

SendGrid is Twilio-owned (acquired 2019). Together with @codespar/mcp-twilio this package closes the messaging loop:

  • Twilio — SMS, WhatsApp, Voice, Verify
  • SendGrid — email (transactional + marketing)

Agents building commerce notification flows — order confirmations, shipping updates, abandoned-cart nudges, promos — can now cover every channel through two packages.

Tools (20)

ToolPurpose
send_mailSend an email via POST /mail/send.
send_templateConvenience wrapper for POST /mail/send with a dynamic template.
add_contactUpsert contacts in Marketing Campaigns via PUT /marketing/contacts.
list_contactsList Marketing Campaigns contacts via GET /marketing/contacts.
delete_contactDelete contacts by id via DELETE /marketing/contacts?ids=....
search_contactsSearch contacts with an SGQL query via POST /marketing/contacts/search.
get_contactRetrieve a single Marketing Campaigns contact by id via GET /marketing/contacts/{id}.
list_listsList all Marketing Campaigns contact lists via GET /marketing/lists.
create_listCreate a Marketing Campaigns contact list via POST /marketing/lists.
delete_listDelete a Marketing Campaigns contact list via DELETE /marketing/lists/{id}.
list_templatesList transactional templates via GET /templates.
create_templateCreate a transactional template via POST /templates.
list_suppressionsList all suppressed recipients for an unsubscribe group via GET /asm/groups/{group_id}/suppressions.
add_suppressionAdd recipients to a suppression group via POST /asm/groups/{group_id}/suppressions.
list_unsubscribe_groupsList all unsubscribe groups on the account via GET /asm/groups.
get_bouncesRetrieve bounced recipients via GET /suppression/bounces.
delete_bounceRemove a bounced address from the bounce suppression list via DELETE /suppression/bounces/{email}.
cancel_scheduled_sendCancel or pause a scheduled send by batch_id via POST /user/scheduled_sends.
get_event_webhook_settingsRetrieve the Event Webhook configuration via GET /user/webhooks/event/settings.
get_statsGlobal email stats via GET /stats.

Install

bash
npm install @codespar/mcp-sendgrid

Environment

bash
SENDGRID_API_KEY="SG...."         # required (secret)SENDGRID_FROM_EMAIL="[email protected]"   # optional default sender

The SENDGRID_FROM_EMAIL must be either a Verified Sender or belong to an authenticated domain.

Authentication

Bearer-token auth. The server handles this automatically.

Authorization: Bearer <SENDGRID_API_KEY>

API surface

  • Base URL: https://api.sendgrid.com/v3
  • All requests/responses are application/json
  • POST /mail/send returns 202 Accepted on success (no body)

Send with a dynamic template

json
{  "to": "[email protected]",  "template_id": "d-abc123...",  "dynamic_template_data": {    "order_id": "1001",    "total_brl": "R$ 249,90",    "tracking_url": "https://example.com/track/1001"  }}

Run

bash
# stdio (default — for Claude Desktop, Cursor, etc)npx @codespar/mcp-sendgrid
# HTTP (for server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-sendgrid

Pairs with

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/communication/sendgrid/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts