PlugWiki
SendGrid MCP Server logo

SendGrid MCP server (community): connect SendGrid to Claude, Cursor and more

CommunityLocal
Getnpmsendgrid-mcpdeyikong/sendgrid-mcp

Lets your AI assistant read your SendGrid stats, contacts and templates, and send email or make changes only when you allow it.

This community server connects Claude, Cursor, Codex and other assistants to your SendGrid account through its API. It can read stats, contacts, templates, campaigns and delivery history, and it can send mail and change settings. It starts in read-only mode, so nothing is sent or changed until you switch that off. It is built by a SendGrid engineer as an independent project, not by Twilio, and it uses your own SendGrid API key.

Good for

  • Email marketers who want campaign, open and bounce numbers in plain answers
  • Developers debugging why a transactional email did not arrive
  • Teams managing contacts, lists and unsubscribes without clicking through the dashboard
  • Anyone drafting or updating SendGrid email templates with an assistant

Works in

5 supported · 7 should work

Tap an app to see how to set it up and any known problems.

Install SendGrid MCP

Claude Code

  1. 1

    Copy this prompt.

    Add the SendGrid MCP server to Claude Code. Run this command:
    
    claude mcp add sendgrid -e SENDGRID_API_KEY=<SENDGRID_API_KEY> -e READ_ONLY=true -- npx -y sendgrid-mcp
    
    Ask me for SENDGRID_API_KEY and only put the values in that config, nowhere else.
    
    Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Read-only mode: On by default. Keep READ_ONLY set to true to block sending and changes; set it to false only when you want the assistant to send mail or edit your account.

Community server, not made by Twilio SendGrid. It starts in read-only mode: the assistant can look things up, but sending and changes are blocked until you set READ_ONLY to false. Needs Node.js 20 or newer. It calls SendGrid's global API, so accounts on EU data residency are not covered. The README shows a config entry for Claude Code; the command above adds the same server with npx.

Built from the package data we hold. Not yet tested by us.

Tools

  • Finds sent emails by recipient, status or subject to see what happened

    Searches the activity of emails you sent, by recipient, status or subject, so you can find out why a message did or did not arrive.

    Try: “Did the password reset email to jane@example.com get delivered?”

    Read · search_email_activity

  • Shows the full delivery history of one sent email

    Get full delivery event history and details for a single sent message by its message ID.

    Try: “Show every delivery event for this message ID”

    Read · get_message_details

  • Shows overall email stats like delivered, opens, clicks and bounces

    Shows account-wide email statistics such as requests, deliveries, opens, clicks and bounces for a date range.

    Try: “How did our email do last week: delivered, opens, clicks and bounces?”

    Read · get_global_stats

  • Breaks down link clicks by browser

    Shows clicks grouped by browser.

    Try: “Which browsers do people click our links from?”

    Read · get_stats_by_browser

  • Breaks down opens by email app type

    Shows opens grouped by email client type: desktop, mobile or webmail.

    Try: “Do more people open our emails in webmail or on desktop?”

    Read · get_stats_by_client_type

  • Breaks down opens by desktop, mobile or tablet

    Shows opens grouped by device type: desktop, mobile or tablet.

    Try: “How many of our opens come from mobile?”

    Read · get_stats_by_device_type

  • Breaks down opens and clicks by country

    Shows opens and clicks grouped by country.

    Try: “Which countries open our emails most?”

    Read · get_stats_by_country

  • Breaks down stats by inbox provider like Gmail or Outlook

    Shows email statistics per mailbox provider, such as Gmail, Outlook or Yahoo, including blocks, bounces, opens and clicks.

    Try: “Are Gmail users bouncing more than Outlook users?”

    Read · get_stats_by_mailbox_provider

  • Shows stats for emails tagged with a category

    Shows statistics for emails tagged with specific categories, for up to the last 13 months.

    Try: “How did emails in the onboarding category perform?”

    Read · get_category_stats

  • Shows stats for specific subusers

    Retrieve email statistics for specific subusers.

    Try: “Compare sending stats for our two subusers”

    Read · get_subuser_stats

  • Gives an overview of email performance across several breakdowns

    Get a comprehensive overview of email statistics across multiple dimensions.

    Try: “Give me an overview of our email performance this month”

    Read · get_stats_overview

  • Lists your contact lists

    List all email lists.

    Try: “What contact lists do we have?”

    Read · list_email_lists

Read from the source code

Pros and cons

Good

  • Read-only by default, so nothing is sent or changed until you allow it.
  • Covers most of SendGrid: stats, contacts, templates, campaigns, automations, suppressions and settings.
  • Can look up what happened to a specific sent email.
  • Built by a SendGrid engineer and updated recently.
  • Runs on your machine, or over the web for Claude custom connectors.
  • Free and open source.

Watch out

  • Not an official Twilio SendGrid product, so Twilio does not support it.
  • With 154 tools it uses a lot of the assistant's context.
  • No setting for SendGrid's EU data residency accounts.
  • Needs Node.js 20 or newer.

Permissions

high risk · 5 things to watch

High risk

With read-only mode off, the assistant can send real email from your domain and delete contacts, lists and templates. Leave read-only on and use a SendGrid key limited to the permissions you need.

What it can do

Watch out for

  • It can send real email from your domain

    Once read-only is off, the send tool delivers mail to any address you or the assistant give it. Keep read-only on unless you need sending. github.com

  • It can delete contacts, lists and templates

    With read-only off it can also remove senders, segments, webhooks and sending domains. Approve each tool call before it runs. github.com

  • A Full Access key reaches your whole account

    Create a key with only the permissions you need. Every request the assistant makes runs with that key. github.com

  • Contact details go to the AI model

    Listing or searching contacts sends names and email addresses to your AI provider. github.com

  • Checking an address costs a credit

    Email address validation uses a paid SendGrid validation credit for each check. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyOn by default. READ_ONLY=true keeps every tool visible but blocks create, update, delete and send calls at runtime; set READ_ONLY=false to allow them.
Talks toapi.sendgrid.com
Sign-in and keysSENDGRID_API_KEY in the client config or environment.

Alternatives

Use this server for the widest SendGrid coverage with sending off by default. Pick SendGrid Transactional to check emails before they go out, mcp-sendgrid-server if your account is in the EU, SendGrid Secure for allowlists and dry runs, and Pipeworx SendGrid if you want a hosted address.

ServerOfficialRunsRead-only by defaultCan change thingsWeekly downloads
sendgrid-mcpThis pageCommunityLocalYesYes369/wk
SendGrid TransactionalCommunityLocalNoYes50/wk
mcp-sendgrid-serverCommunityLocalYesYes20/wk
SendGrid SecureCommunityLocalDry runYes–
Pipeworx SendGridCommunityHostedLocal––14/wk

Questions

Is there an official SendGrid MCP server?

No. Twilio SendGrid does not publish one, and Twilio's own MCP server covers the Twilio API, not SendGrid email. This server is an independent project by a SendGrid engineer.

Can it send email?

Yes, but not by default. Sending is blocked until you set read-only mode to false in the server's settings.

Is it safe to connect to my SendGrid account?

It is safe to start with, because it can only read until you switch read-only off. Before you do, create an API key with only the permissions you need and keep tool approval on, since it can then send mail and delete data.

What API key does it need?

A SendGrid API key starting with SG., created under Settings, API Keys. The README offers Full Access or chosen permissions; pick only what you need.

Is it free?

Yes. The server is free and open source. Your SendGrid plan's sending limits still apply, and email address checks use paid validation credits.

Does it work with SendGrid EU accounts?

No. It always calls SendGrid's global API. The community mcp-sendgrid-server has a setting for EU data residency accounts.

Can I use it with Claude on the web?

Yes, if you run it as a web server, either on your own host or on MCP Market's hosting. Then add that address in Claude as a custom connector.

Why does it say the operation is blocked?

Read-only mode is on, which is the default. Set it to false in your app's config and restart if you want the assistant to make changes.

Examples

  • Review your marketing automations

    List my SendGrid automations

    Source
  • Find out why an email did not arrive

    Did the password reset email to jane@example.com get delivered?

  • Weekly email performance check

    How did our email do last week: delivered, opens, clicks and bounces?

  • Clean up bounces after a list import

    Which addresses bounced this week?

Information

updated Nov 2, 2026

Publisher
Community
Package
sendgrid-mcp
Registry
npm
Transport
stdio
Auth
API key
Version
1.4.0
License
ISC
Last commit
Oct 28, 2026
Open issues
0
Listed in
Official MCP registry

GitHubnpmOfficial MCP RegistryChangelogIssues

Other SendGrid MCP servers

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 6
  1. sendgrid-mcp README · github.com
  2. sendgrid-mcp on npm · npmjs.com
  3. Twilio Labs MCP · github.com
  4. mcp-sendgrid-server · npmjs.com
  5. @neschadin/sendgrid-mcp · npmjs.com
  6. sendgrid-mcp-secure · pypi.org

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.