list_contactsLABSCO SUMMARY
Marketing sends assembled and fired in one thread.
The list, the contacts, the template and the send are four screens in SendGrid and four tool calls here. It suits the small campaign that would otherwise not be worth opening the dashboard for.
What it is
A server over SendGrid's v3 Marketing API. Contacts are added, listed and deleted; lists are created, filled, pruned and deleted; email goes to a single recipient or to a whole list through the Single Sends API. It supports v3 only — dynamic templates, Marketing API contacts, Single Sends — not the legacy equivalents.
What you get
- Every contact in the account listed, and contacts added with first name, last name and custom fields
- Contacts deleted by email address
- Contact lists created, listed and deleted
- Contacts added to and removed from a list
- Every contact in a list read back by list ID
- A single email sent
- A send to an entire list, through Single Sends
Requirements
A SendGrid account and an API key with Marketing API access. Sending also needs a verified sender and an unsubscribe group, which live in the account rather than in the server. Legacy templates are not supported — set the campaign up with a dynamic template.
Setup effort
Build from source — git clone https://github.com/Garoth/sendgrid-mcp.git
USE CASES
01
Standing up a list for a one-off campaign
Create the list, add the people, and attach them to it without touching the SendGrid UI.
02
Sending to everyone on a list
The send goes through the Single Sends API, so a whole list is one call rather than a loop over addresses.
03
Checking who is actually on it
Read the lists in the account and the contacts inside the one you are about to mail.
04
Sending a test before the campaign
One recipient, one call, using the same template the list send will use.
05
Keeping the list clean
Take people off a list without deleting them from the account, or remove them from the account entirely.
06
Retiring a campaign
Delete the list once the campaign is finished, leaving the contacts themselves in place.
19 tools
Listed in project docs. Your client may show a different list.
add_contactdelete_contactsget_contacts_by_listlist_contact_listscreate_contact_listdelete_listadd_contacts_to_listremove_contacts_from_listsend_emailsend_to_listcreate_templatelist_templatesget_templatedelete_templateget_statsvalidate_emaillist_verified_senderslist_suppression_groupsBEFORE YOU INSTALL
What to know first
Tools you get
19 tools named in the project's documentation.
Requires
SENDGRID_API_KEY in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/Garoth/sendgrid-mcp.git
cd sendgrid-mcp
npm installMCP Clients
Cline
CLINE · JSON
{
"mcpServers": {
"sendgrid": {
"command": "node",
"args": [
"<YOUR_PATH_TO_SENDGRID_MCP>/build/index.js"
],
"env": {
"SENDGRID_API_KEY": "<YOUR_SENDGRID_API_KEY>"
},
"disabled": false,
"autoApprove": [
"list_contacts",
"list_contact_lists",
"list_templates",
"list_single_sends",
"get_single_send",
"list_verified_senders",
"list_suppression_groups",
"get_stats",
"validate_email"
]
}
}
}
