Sendblue

An MCP (Model Context Protocol) server that exposes Sendblue's iMessage and SMS capabilities as tools for LLMs.

This MCP server acts as an interface to the Sendblue API, enabling LLMs to send messages, manage groups, and perform other communication-related tasks via iMessage and SMS. It follows the MCP specification and provides a standardized way for LLMs to interact with the Sendblue platform.

The server provides the following tools:

- send_message: Send individual messages (iMessage/SMS) with support for text, media, and expressive styles
- send_group_message: Send messages to group chats
- lookup_number_service: Check if a number supports iMessage or SMS
- send_typing_indicator: Send typing indicators to recipients
- get_message_history: Retrieve message history
- add_recipient_to_group: Add new recipients to existing group chats
- upload_media_for_sending: Upload media from URLs to Sendblue servers

# Clone the repository git clone https://github.com/your-username/sendblue-mcp.git cd sendblue-mcp # Install dependencies pip install -r requirements.txt # Set up credentials cp sample.env .env # Edit .env and add your API credentials # Add to Claude Desktop config (macOS) echo '{ "mcpServers": { "sendblue": { "command": "python", "args": ["-m", "src.main"], "cwd": "'$(pwd)'" } } }' > ~/Library/Application\ Support/Claude/claude_desktop_config.json # Restart Claude Desktop

# After cloning and installing dependencies python start_sendblue.py

- Python 3.10 or higher
- Sendblue API credentials (API Key ID and Secret Key)

git clone https://github.com/your-username/sendblue-mcp.git cd sendblue-mcp

Configure your Sendblue API credentials:

cp sample.env .env # Edit .env to add your API credentials

SENDBLUE_API_KEY_ID=your_api_key_id_here SENDBLUE_API_SECRET_KEY=your_api_secret_key_here

-

Ensure you're in the project directory:

The server will start using the configuration from your.envfile.

Claude Desktop allows you to use the Sendblue MCP server directly from the Claude interface:
-

Locate the Claude Desktop configuration file:

- macOS:~/Library/Application Support/Claude/claude_desktop_config.json
- Windows:%AppData%\Claude\claude_desktop_config.json

Create or edit the file and add the following configuration:

{ "mcpServers": { "sendblue": { "command": "python", "args": [ "-m", "src.main", "--directory", "/absolute/path/to/sendblue-mcp" ] } } }

Replace/absolute/path/to/sendblue-mcpwith the actual path to your Sendblue MCP server directory

Save the file and restart Claude Desktop

The Sendblue tools will appear in the Claude interface when you click on the hammer icon

To add the Sendblue MCP server to Cursor:

- macOS: PressCmd + ,
- Windows/Linux: PressCtrl + ,

- Go to "Features" > "MCP Servers"

Click "Add Server" and configure:

- Server Name:sendblue
- Command:python
- Args:["-m", "src.main"]
- Working Directory:/absolute/path/to/sendblue-mcp
- Environment Variables:

{ "SENDBLUE_API_KEY_ID": "your_api_key_id", "SENDBLUE_API_SECRET_KEY": "your_api_secret_key" }

- Open the AI chat
- You should see Sendblue tools available when you click the tools icon
- Try running@sendblue send test messageto confirm it's working

If the MCP server doesn't appear in Claude Desktop:
- Check Claude's logs (macOS):tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
- Verify your.envfile has valid Sendblue API credentials
- Make sure the path in the config file is absolute and correct
- Try restarting the client application completely

docker build -t sendblue-mcp . docker run -p 5000:5000 --env-file .env sendblue-mcp

This server is compatible with Smithery hosting. Deploy using:
- Sign up for a Sendblue account athttps://sendblue.co/
- Once logged in, navigate to the API dashboard
- Generate your API Key ID and API Secret Key
- Store these credentials securely as they will be needed to authenticate with the Sendblue API

SENDBLUE_API_KEY_ID=your_api_key_id_here SENDBLUE_API_SECRET_KEY=your_api_secret_key_here MCP_TRANSPORT=stdio # or http for web transport

{ "mcpServers": { "sendblue": { "command": "python", "args": [ "-m", "src.main" ], "env": { "SENDBLUE_API_KEY_ID": "your_api_key_id_here", "SENDBLUE_API_SECRET_KEY": "your_api_secret_key_here" } } } }

When deploying to Smithery, you'll be prompted to input these environment variables through the Smithery interface. The deployment will securely store these values and provide them to your server at runtime.

Additional configuration is managed through environment variables:

- MCP_TRANSPORT: Transport method (stdioorhttp); defaults tostdio
- MCP_HTTP_PORT: Port number for HTTP transport; defaults to5000

The project includes a comprehensive test suite:

- API Documentation- Generated documentation for the Sendblue API
- Sendblue Documentation- Original Sendblue API documentation

Gives an AI agent a disposable email and a real UK phone number to test signup/verification flows end to end