Home / Sendblue CLI

Sendblue CLI

Send iMessages from your terminal

The fastest way to send and receive iMessages programmatically. No app, no phone, just code.

Get Started
npm install -g sendblue-cli Copied!
Terminal 
# Send your first iMessage from the command line
$ npx sendblue send --to "+1234567890" --message "Hello from the CLI"

✓ Message sent successfully
  Status: QUEUED
  To:     +1234567890
  Type:   iMessage

Quick Start

Go from zero to sending iMessages in under two minutes.

1

Install the CLI

Install globally via npm, or skip the install entirely with npx sendblue.

2

Authenticate

Run sendblue auth to save your API key and secret from dashboard.sendblue.com. Credentials are stored locally.

3

Send a message

Run sendblue send --to "+1..." --message "Hello" and your iMessage is delivered instantly.

Terminal 
# Step 1: Install
$ npm install -g sendblue-cli

# Step 2: Authenticate
$ sendblue auth
  Enter API Key: sb_****
  Enter API Secret: ****
  ✓ Credentials saved

# Step 3: Send an iMessage
$ sendblue send --to "+1234567890" --message "Hello from the CLI"
  ✓ Message sent successfully

Everything You Need in a CLI

Send iMessages, receive replies, attach media, and more — all from your terminal.

Send iMessages

Send real iMessages (blue bubbles) to any iPhone user directly from your terminal. Messages appear natively in the recipient's Messages app.

Receive & Read Messages

Set up webhooks to receive incoming iMessages in real time. Read full conversation history and track delivery statuses.

Group Messaging

Create and send to iMessage group conversations. Perfect for team alerts, multi-party sales threads, and collaborative workflows.

Rich Media

Attach photos, videos, and vCards (contact cards) to your messages. Send files as easily as text, directly from the command line.

RCS Fallback for Android

When a recipient does not have iMessage, messages automatically fall back to RCS or SMS. One command covers every phone.

Fully Scriptable

Pipe the Sendblue CLI into bash scripts, cron jobs, CI/CD pipelines, or any automation. Works with any language via shell exec.

MCP Integration

Use iMessage in Claude Code

Sendblue offers an MCP (Model Context Protocol) server that gives AI coding assistants direct access to iMessage. Add it to Claude Code, Cursor, VS Code, or any MCP-compatible tool in one command.

  • Send iMessages from your AI assistant
  • Read and search conversation history
  • Manage contacts and groups
  • Automate outreach flows with natural language

No competitor offers this level of AI integration.

Terminal 
# Add Sendblue MCP to Claude Code
$ claude mcp add sendblue_api -- \
    npx -y sendblue-api-mcp

✓ MCP server added

# Now in Claude Code, just ask:
> "Send an iMessage to +1234567890
   saying our meeting is at 3pm"

✓ iMessage sent via Sendblue

Built for Every Use Case

From quick tests to production workflows, the Sendblue CLI fits into how you already work.

Sales Outreach Automation

Script personalized iMessage sequences for leads. Blue bubbles get 4x higher response rates than SMS or email.

Customer Support

Let support agents reply to customers via iMessage directly from their terminal or integrate with your existing helpdesk tools.

Appointment Reminders

Healthcare, dental, and service businesses use cron jobs with the CLI to send automated appointment reminders via iMessage.

Two-Factor Authentication

Deliver OTP codes via iMessage for higher deliverability and trust compared to standard SMS-based 2FA.

Marketing Campaigns

Run iMessage marketing campaigns with rich media, contact cards, and group messaging. Reach customers on the channel they check most.

Developer Testing

Quickly prototype and test iMessage integrations without writing application code. Perfect for hackathons, MVPs, and demos.

Free to Start

The Sendblue CLI is free to install. Get 100 free messages when you sign up — no credit card required. After that, pay as you go or choose a plan starting at $100/line/month.

View pricing & plans

Frequently Asked Questions

How do I send an iMessage from the command line?

Install the Sendblue CLI with npm install -g sendblue-cli, then authenticate with sendblue auth. Once set up, run sendblue send --to "+1234567890" --message "Hello" to deliver a real iMessage. You can also skip the global install and use npx sendblue send ... directly. Messages are delivered as blue bubbles through Apple's iMessage protocol.

Can I use iMessage in Claude Code?

Yes. Run claude mcp add sendblue_api -- npx -y sendblue-api-mcp to add the Sendblue MCP server to Claude Code. Once connected, you can send iMessages, read conversations, and manage contacts using natural language directly in your AI coding assistant. This also works with Cursor, VS Code, and any MCP-compatible tool.

Is the Sendblue CLI free?

The CLI itself is completely free and open source. When you create a Sendblue account, you get 100 free messages to test with — no credit card required. After that, pricing is pay-as-you-go or you can choose a monthly plan starting at $100/line/month for production use.

What can I do with the Sendblue CLI?

You can send and receive iMessages, send group messages, attach photos and videos, send contact cards (vCards), and automatically fall back to RCS or SMS for Android recipients. The CLI is fully scriptable, so you can integrate it into bash scripts, cron jobs, CI/CD pipelines, or call it from any programming language via shell exec.

Does the Sendblue CLI work on Windows, Mac, and Linux?

Yes. The Sendblue CLI runs anywhere Node.js runs — macOS, Linux, and Windows. You do not need a Mac or an iPhone to send iMessages. Sendblue handles the Apple infrastructure in the cloud, so your CLI commands work from any operating system.

Start sending iMessages
from your terminal

Install the CLI, authenticate, and send your first iMessage in under two minutes. Free to start.

Get API Access Read the docs

Also from Sendblue

MCP Server — For AI agents & IDE integration REST API — Full programmatic access