iBlueText — Claude Code MCP server: what it does, how to install
iBlueText sends iMessage, SMS, and WhatsApp messages directly from your AI client. Helpful for managing text campaigns, verifying phone numbers, and handling replies.
MIT updated 2026-10-29
claude mcp add --transport http ibluetext https://ibluetext.com/mcpWhat iBlueText does
This server bridges your AI environment with a dedicated business number to handle direct customer messaging. It checks which phone numbers belong to iPhones, delivers single iMessage, SMS, or WhatsApp texts, and handles campaign batches with merge tags. The toolset also supports conversation tracking, automated lead scores, and sequence enrollment.
Integration works via two setups. You can point your client to the hosted streamable endpoint at https://ibluetext.com/mcp using OAuth sign-in to unlock 22 tools. Alternatively, running the local package through npx -y ibluetext-mcp with an IBT_API_KEY opens 30 tools, adding SMS verification widgets and reply webhooks.
If your account runs out of credits or lacks an active line, paid operations immediately stop with a 402 error. WhatsApp lines follow strict warm-up schedules, starting at 10 conversations on day 1 and reaching 300 by day 21. Contacts who never reply cannot receive more than 3 follow-ups, and falling below a 15% response rate across 7 days cuts daily volume in half.
What it helps with
- check whether target phone numbers use iMessage or WhatsApp
- trigger bulk SMS or iMessage campaigns with template merge tags
- review conversation transcripts and lead scores inside your agent
- set up SMS phone verification workflows with local widgets
Example prompts for the agent
- Check the numbers in leads.txt to see which ones support iMessage.
- Send an iMessage update to +1234567890 saying their order is ready.
- List our active conversations along with recent lead scores.
How to install iBlueText
Platform CLI: remote server
claude mcp add --transport http ibluetext https://ibluetext.com/mcpPlatform CLI: remote server
codex mcp add ibluetext --url https://ibluetext.com/mcpConfig file
{
"mcpServers": {
"ibluetext": {
"url": "https://ibluetext.com/mcp"
}
}
}Config file
{
"servers": {
"ibluetext": {
"type": "http",
"url": "https://ibluetext.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http ibluetext https://ibluetext.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about iBlueText
How do I install iBlueText in Claude Code?
Run claude mcp add --transport http ibluetext https://ibluetext.com/mcp in your terminal and complete the OAuth authorization screen.
What does iBlueText do?
It gives your assistant tools to send iMessage, SMS, and WhatsApp texts from a dedicated business number, verify device platforms, and inspect incoming replies.
What is the difference between the hosted URL and the local package?
The hosted endpoint exposes 22 tools with OAuth authentication. The local npm package requires an IBT_API_KEY and adds tools for SMS verification, webhooks, and widget management.