Sendblue MCP server
Commit Nov 11, 2026Enables AI clients to send customer messages, read replies, and monitor messaging health within a Sendblue workspace.
Also known as sendblue-api/sendblue-grok-plugin, sendblue-grok-plugin
- Stars
- 0
- Tools
- 6
- Downloads, 30 days
- —
- Latest version
- 1.0.0
- Last commit
- Nov 11, 2026
- License
- —
What is Sendblue MCP?
Sendblue enables AI clients to send customer messages, read replies, and monitor messaging health within a Sendblue workspace. It exposes 6 tools, such as ping, list_lines, list_messages.
Summary generated from the project's README
About Sendblue MCP server
Managing customer communications and monitoring messaging health directly from AI clients is what Sendblue enables. Developers and teams using Claude, Grok Bot, or Cursor can interact with their Sendblue workspace to send text messages, read recent message history, and track delivery statuses. The server operates via a remote HTTPS connection using OAuth for secure authentication, allowing users to sign in with their existing Sendblue accounts and select specific workspaces.
Users can perform various tasks using specialized tools like send_message for outbound texts and list_messages to view incoming replies. For maintaining service quality, the evaluate_service tool provides summaries of outbound messaging health by sampling recent activity. The system supports granular permissions, where users can grant messages:read for history and health monitoring or messages:send for active communication. This setup allows for a centralized way to handle SMS workflows without leaving the AI interface.
What you can do with it
- 1Verify messaging connectivityAsk the AI to check if the Sendblue connection is active and identify available sending numbers.
- 2Retrieve recent conversation historyRequest the most recent messages for a specific contact to understand recent interactions.
- 3Execute outbound text messagesInstruct the AI to send a specific text to a recipient and then verify the delivery status.
- 4Monitor service performanceRequest a summary of outbound messaging health over a specific time period like the last 24 hours.
Written from the project's README. Every use case is checked against a quote from it.
How to install Sendblue MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Sendblue MCP in Claude Code
$ claude mcp add --transport http sendblue-grok-plugin https://api.sendblue.co/mcpInstall Sendblue MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"sendblue-grok-plugin": {
"url": "https://api.sendblue.co/mcp"
}
}
}Install Sendblue MCP in VS Code
.vscode/mcp.json
{
"servers": {
"sendblue-grok-plugin": {
"type": "http",
"url": "https://api.sendblue.co/mcp"
}
}
}Install Sendblue MCP in VS Code CLI
$ code --add-mcp '{"name":"sendblue-grok-plugin","type":"http","url":"https://api.sendblue.co/mcp"}'Install Sendblue MCP in Codex
$ codex mcp add sendblue-grok-plugin --url https://api.sendblue.co/mcpInstall Sendblue MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.sendblue-grok-plugin] url = "https://api.sendblue.co/mcp"
Install Sendblue MCP in Gemini CLI
$ gemini mcp add -s user --transport http sendblue-grok-plugin https://api.sendblue.co/mcpInstall Sendblue MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"sendblue-grok-plugin": {
"url": "https://api.sendblue.co/mcp",
"type": "http"
}
}
}Sendblue MCP tools 6
Detected from the READMEpinglist_lineslist_messagessend_messageget_message_statusevaluate_service
Automated checks
Ran Nov 14, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablesendblue-api/sendblue-grok-plugin is public and reachablegithub.com/sendblue-api/sendblue-grok-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-11github.com/sendblue-api/sendblue-grok-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeHTTPS endpoint answered 401 (sign-in required)Pass
README
View on GitHubSendblue
Send customer messages, read replies, and check delivery from your Sendblue workspace in Claude, Grok Bot, and Cursor.
The plugin connects to Sendblue's hosted MCP server using Streamable HTTP and OAuth. Sign in with your Sendblue account, choose the workspace, and grant the permissions you want to use.
Connect in Claude
- Open Customize > Connectors and select Add > Add custom connector.
- Enter Sendblue as the name and
https://api.sendblue.co/mcpas the server URL. - Review the detected OAuth configuration. Use Register automatically for the OAuth client and leave request headers empty.
- Complete setup, connect, and sign in to Sendblue. Select the workspace and approve the read and/or send permissions you need.
- Start a conversation with Sendblue enabled and ask Claude to check the connection.
Team and Enterprise owners add the connector in their organization settings first. Members then connect their own Sendblue accounts from Customize > Connectors.
The custom connector is available now. The Claude directory listing is being prepared for review.
Connect in Grok Bot
- Open Connect apps and choose Add a custom connector.
- Enter Sendblue as the name and select Remote HTTPS.
- Enter
https://api.sendblue.co/mcpas the server URL. - Leave HTTP headers and Client ID empty. Choose Add plugin.
- Complete the browser authorization. If the connector shows an initial error, choose Reconnect and complete authorization.
- Return to Grok Bot and verify Connected with 6 of 6 enabled.
This is the custom-connector installation flow. Marketplace distribution is pending review.
Connect in Cursor
Add this server to your MCP configuration, then complete its OAuth sign-in.
{
"mcpServers": {
"sendblue": {
"url": "https://api.sendblue.co/mcp"
}
}
}
For local plugin development, copy this plugin directory into ~/.cursor/plugins/local/sendblue, reload Cursor, and inspect the discovered components in Customize. Follow your team's plugin policy.
Available tools
| Tool | Purpose |
|---|---|
ping |
Check connectivity and echo a supplied message |
list_lines |
Find sending numbers assigned to the connected account |
list_messages |
Read recent messages, with contact and direction filters |
send_message |
Send one text message from the connected account |
get_message_status |
Check a message using the UUID returned by Sendblue |
evaluate_service |
Summarize recent outbound messaging health over a bounded window |
Example requests
- Check my Sendblue connection and list my available sending numbers.
- Show the three most recent messages for the contact I specify.
- Send the exact text I provide to the recipient I specify, then check its status.
- Summarize outbound messaging health over the past 24 hours, including sampling and denominators.
Permissions and sending
messages:read permits message-history and account-health reads. messages:send permits message sending. Send-only access can check the status of a send made by the connected app. Access follows the workspace and permissions authorized in Sendblue.
Use a fresh UUID idempotency_key for each intentional send. Retry the same send with identical inputs and the same key. Check the returned message UUID when the outcome is uncertain.
Free-plan accounts must specify a sending line and use a recipient whose shared-line routing is already established. Follow the Sendblue dashboard's recipient setup flow before testing sends on such accounts.
evaluate_service samples at most the newest 100 messages in the requested window. Include the window, sample size, total count, and relevant denominators when reporting its results. SMS lacks delivery receipts, so confirmed-delivery rates need to be interpreted alongside the service mix.
Disconnect or revoke access through Sendblue Connected Apps. Grok Bot connections are account-wide and may be used by the other Bots on that account.
Support and terms
- Sendblue documentation
- Sendblue website
- Support email is support@sendblue.com.
- Privacy policy
- Terms of service
Platform references
Official MCP Registry
The hosted messaging connector is described in server.json as io.github.sendblue-api/sendblue. It uses the same OAuth-protected HTTPS endpoint documented above. The manually dispatched Publish official MCP Registry metadata GitHub Actions workflow publishes metadata using short-lived GitHub OIDC credentials; no repository secret or additional DNS record is needed. The repository contains client configuration and listing metadata; the remote service is operated by Sendblue.
Sendblue MCP questions
How do I add Sendblue MCP to Claude Code?
Run claude mcp add --transport http sendblue-grok-plugin https://api.sendblue.co/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Sendblue MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Sendblue MCP provide?
It exposes 6 tools, including ping, list_lines, list_messages, send_message, get_message_status.
What permissions are required to use Sendblue?
The 'messages:read' permission allows for message history and account health reads, while 'messages:send' permits sending messages.
How can I check the status of a sent message?
You can use the get_message_status tool with the UUID returned by Sendblue to check a specific message.
Are there limitations for free-plan accounts?
Free-plan accounts must specify a sending line and use a recipient whose shared-line routing is already established via the Sendblue dashboard.