Skip to the page
BlueBot

BlueBot docs

Your Mac has a texting API now.

Send texts from your own number with one API call and get every reply as a signed webhook. These docs also cover Zapier, Make, n8n, Pipedream and AI assistants.

Open in Claude Open in ChatGPT .md

BlueBot sends iMessages and SMS from your own phone number. It needs a Mac you own that stays on with Messages signed in. When your app, your Zap or your AI assistant asks BlueBot to send a text, the person gets it from you in their existing conversation with you. Every reply, delivery and read comes back to you as a signed webhook.

Send your first textGet a key and text yourself in four steps. It takes about five minutes.API referenceEvery operation, its fields, its errors, and a Try it panel.

What are you building?

Texts from my own appSend with one request and react to replies with webhooks.An AI that textsGive Claude, ChatGPT or Cursor tools to text, read and check your Mac.A Zap or a scenarioUse Zapier, Make, n8n or Pipedream without writing code.Reminders and follow-upsScheduled texts that wait for the right time and stop when someone replies.Replies in my CRMLog every text in and out on the person's record.A webhook handlerGet a signed event for every text, with retries and replay.

How it works

  1. 1Your app calls POST /v1/messages (or Zapier, n8n, an AI agent).
  2. 2BlueBot queues it and applies your sending rules. A text that can’t go yet waits with a hold.
  3. 3Your Mac checks in every 10 seconds, claims the text and hands it to Messages.
  4. 4Messages sends it as an iMessage, or as an SMS through your iPhone.
  5. 5Replies are read from Messages on the Mac and sent to your app as webhooks.
How a text goes out and how a reply comes back.

Your app calls POST/v1/messages. BlueBot checks your sending rules and either queues the text or holds it with a reason. Your Mac checks in every 10 seconds, takes the texts that are ready and hands each one to Messages, which sends it as an iMessage or, through your iPhone, as an SMS. The Mac reads the result back from Messages, and BlueBot tells you with a webhook. Read How BlueBot works for the whole path.

What BlueBot is not

  • Anyone who wants to text people who didn’t ask to hear from them. BlueBot is not a bulk SMS gateway and has no cold outreach.
  • Anyone who needs a number they don’t own. BlueBot sends from your own number and provides none.
  • Anyone without a Mac that can stay on with Messages signed in.

BlueBot is for texting people who know you and want to hear from you, such as clients, customers and patients. The sending rules keep it that way, and they're why your number stays in good standing with Apple and the carriers.

Where to go next

  • Quickstart: a key, a test text to yourself, and what to know before you send in a loop.
  • Holds: why a text waits instead of failing, and when it goes.
  • Webhooks: hear about every text in and out.
  • MCP: let an AI assistant text for you under your sending rules.
  • llms.txt: these docs for a language model, one link per page.