Skip to main content
Text GAIA from the Messages app on your iPhone, iPad, or Mac.
iMessage is a Pro feature. Every other GAIA bot is available on the free plan.

Getting started

There is no public number. Each account gets its own GAIA line when you register.
1

Register your phone number

Open Settings → Linked Accounts, choose iMessage, and enter your phone number in E.164 format (for example +14155550123).GAIA shows you the number to text. It is specific to your account, so copy it from that screen.
2

Text /auth to your GAIA number

Open Messages, start a new conversation with the number GAIA gave you, and send:
You’ll get a link back. Tap it, sign in, and your account is connected.
3

Just type

Every message after that goes straight to GAIA. No command prefix, no mention.

Send from your phone number, not your Apple ID

GAIA only accepts messages sent from a phone number. An Apple ID email gets an automated bounce. To fix it, go to Settings → Messages → Send & Receive and set Start new conversations from to your phone number. Then start a new conversation. Old threads keep their old address.

What you can do

Talk in plain language, or use the same commands as the other bots. See Bot Commands. You can also send photos and documents.

What’s different on iMessage

Troubleshooting

Your message was sent from your Apple ID email rather than your phone number. Change it under Settings → Messages → Send & Receive and start a new conversation, as described above.
iMessage is Pro-only, and the plan is re-checked on every message. If your subscription lapsed, the bot stops replying until it’s active again.
Expected. GAIA only responds in direct messages, group conversations are ignored by design.
Want to run your own iMessage bot instead? See iMessage Bot Development.