sendblue-sendblue-cli

name	sendblue-sendblue-cli
description	Send iMessage and SMS from the shell via the @sendblue/cli npm package — outbound sends, contact management, and account setup with no API client or webhook server required.
category	api-integration
risk	critical
source	community
source_repo	sendblue-api/sendblue-cli
source_type	official
date_added	2026-05-22
author	AnthonyFirth
tags	["sendblue","imessage","sms","cli","messaging","notifications"]
tools	["claude","cursor","gemini"]
license	MIT
license_source	https://github.com/sendblue-api/sendblue-cli/blob/main/LICENSE
plugin	{"targets":{"codex":"blocked","claude":"blocked"}}

Sendblue CLI

Overview

@sendblue/cli is a Node CLI that creates a Sendblue account, provisions an iMessage-enabled number, and sends messages. It is the fastest way to text from a shell, script, or Claude Code hook — no API client, no webhook server, no credentials in env vars. Credentials live at ~/.sendblue/credentials.json (mode 600) and Node.js 18+ is required.

When to Use This Skill

• Use when the user wants to text a phone number from a script, shell, hook, or agent turn (e.g. "text me when X finishes", "ping my phone", "notify on completion").
• Use when the user mentions sendblue as a CLI/binary or asks to set up the @sendblue/cli package.
• Prefer this skill over [[sendblue-api]] when the work happens in a shell context, one-shot script, cron job, or agent hook.
• Reach for [[sendblue-api]] instead when writing application code that integrates Sendblue, receiving inbound webhooks, or needing features the CLI does not expose (send styles, reactions, group messages, status callbacks, media uploads).

How It Works

Step 1: Install

npm install -g @sendblue/cli       # global, exposes `sendblue`
# or one-shot:
npx @sendblue/cli <command>

Step 2: Set up an account

sendblue setup runs interactively by default. For CI/scripts, run it in two phases — the first call sends an 8-digit verification code by email, the second consumes it.

sendblue setup --email [e-mail]                                       # sends code
sendblue setup --email [e-mail] --code 12345678 \
               --company my-co --contact [phone]                        # completes setup

Flag	Notes
--email	Email address
--code	8-digit verification code (from the email)
--company	Lowercase, hyphens/underscores, 3–64 chars
--contact	First contact, E.164

Step 3: Send messages

sendblue send [phone] 
sendblue messages --inbound -- 20