Iris.Md logoIris.Md
← All channels

iMessage

alpha

Mac-only bridge using BlueBubbles or sendblue.

In
✓
Out
✓
Auth
Bridge token
§ Required environment

Env vars

IRIS_IMESSAGE_BRIDGE_URL
Required

URL of the BlueBubbles server.

IRIS_IMESSAGE_BRIDGE_TOKEN
Required

API token shared with the bridge.

§ Setup

Step by step

  1. 01

    Run a bridge

    Install BlueBubbles on a Mac that's always on, or sign up for sendblue. Both expose iMessage as an HTTP API.

  2. 02

    Export credentials

    Point Iris.Md at the bridge.

    export IRIS_IMESSAGE_BRIDGE_URL="https://bluebubbles.local"
export IRIS_IMESSAGE_BRIDGE_TOKEN="..."
  3. 03

    Enable the channel

    iMessage is alpha — expect rough edges.

    iris channels enable imessage
§ Success

You're done when

  • ✓Bridge is reachable from the agent host
  • ✓Test message round-trips end-to-end
  • ✓iris logs shows imessage: bridge ok