Give your AI agent
a real iMessage number.
The official Sendblue MCP server. One command in Claude Code, Cursor, or any MCP-compatible host and your agent can read threads, draft replies, and send iMessages.
claude mcp add sendblue_api -- npx -y sendblue-api-mcp
# Add the MCP server to Claude Code $ claude mcp add sendblue_api -- \ npx -y sendblue-api-mcp ✓ Registered sendblue_api # Then, in Claude: › "Text Aria a heads-up that the demo moved to 3 PM Pacific." ✓ Sent via iMessage · msg 01HZ…
Add. Authenticate.
Ask in English.
Three steps stand between an empty MCP host and a real iMessage delivered through your agent.
Add the MCP server
In Claude Code: claude mcp add sendblue_api -- npx -y sendblue-api-mcp. In Cursor / Windsurf / VS Code, paste an equivalent JSON entry under mcpServers. The package is sendblue-api-mcp on npm.
Ask in plain English
Tell the agent what you want — "Text Aria saying the demo moved to 3 PM" — and it routes through the MCP server to Sendblue. The recipient sees a real blue bubble.
// Generic MCP host config { "mcpServers": { "sendblue_api": { "command": "npx", "args": ["-y", "sendblue-api-mcp"], "env": { "SENDBLUE_API_API_KEY": "sb_...", "SENDBLUE_API_API_SECRET": "..." } } } }
Core Sendblue messaging,
exposed as MCP tools.
The core Sendblue tools your agent needs, available by name.
Send iMessage / SMS / MMS
Real blue bubbles via the Apple protocol, with SMS and MMS support for non-Apple recipients.
Read recent threads
Pull recent messages, filter by contact, restrict to inbound or outbound — feed your agent context before it replies.
Media upload
Attach images, video, files, and voice notes to conversations without writing upload or API glue code.
Group threads & typing
Address multi-recipient threads, send native typing indicators, and keep conversations feeling natural.
Contacts & lookup
Add and list contacts, then check whether a phone number supports iMessage before sending.
Delivery status
Check whether a message reached the recipient, was read, or failed — useful for retries and follow-ups.
Works with every
major MCP client.
MCP is an open standard. Anything that speaks it can use the Sendblue MCP server.
Claude Code
Anthropic CLI
Claude Desktop
Anthropic
Cursor
AI code editor
Windsurf
AI IDE
VS Code
via MCP extension
Claude Agent SDK
Custom agents
iMessage as a tool
your agent can reach for.
Common patterns teams build with Sendblue MCP today.
AI support over iMessage
Customers text a dedicated number; the agent reads context with the MCP server and replies as a real blue bubble.
Lead follow-up
An SDR-style agent qualifies inbound leads, books meetings, and nurtures stalled threads — all from within the IDE.
Appointment reminders
Agent checks a calendar, sends iMessage reminders, and handles reschedule replies in the same thread.
Personal assistant
Summarize threads, draft replies, and search history with a natural-language prompt to your IDE.
Deploy + on-call alerts
Send build, deploy, and incident notifications to an oncall iMessage thread directly from Claude Code.
Live thread inspection
Read recent inbound messages from inside the agent — handy for verifying delivery while you build.
Frequently asked questions
More in the docs.
What is the Sendblue MCP server?
It's a Model Context Protocol server (sendblue-api-mcp on npm) that exposes Sendblue's REST API as MCP tools. An MCP-compatible host like Claude Code, Cursor, or Windsurf can install it with one command and then send and receive iMessages by name in natural language.
How do I install it in Claude Code?
Run claude mcp add sendblue_api -- npx -y sendblue-api-mcp. Set SENDBLUE_API_API_KEY and SENDBLUE_API_API_SECRET in the host's environment, then prompt Claude in plain English ("Text Aria saying I'm running late"). The agent calls the MCP server, which calls Sendblue's API.
How do I configure it in Cursor / Windsurf / VS Code?
Add an entry to the host's MCP config (typically a JSON file) under mcpServers: {"command":"npx","args":["-y","sendblue-api-mcp"],"env":{"SENDBLUE_API_API_KEY":"...","SENDBLUE_API_API_SECRET":"..."}}. Restart the host and the tools appear automatically.
Where do I get API credentials?
Two paths. From the dashboard at dashboard.sendblue.com, or from the Sendblue CLI: npm install -g @sendblue/cli then sendblue setup (interactive: email, code, company, contact) and sendblue show-keys.
Is the MCP server free?
The MCP server itself (the npm package) is free. Sendblue accounts include a free sandbox with full API access in a rate-limited test environment; dedicated production lines start at $100/line/month. See pricing.
How is this different from the REST API or CLI?
Same Sendblue API underneath. The CLI is the interactive command-line client; the REST API is for direct integrations. The MCP server is the wrapper that lets an AI agent host call Sendblue tools by name without you having to write API code.
Wire iMessage into your agent.
One command.
Install sendblue-api-mcp, set keys, prompt your agent. Same Sendblue infrastructure used by thousands of businesses.