iMessages AI
Type @anything in iMessage and get a ChatGPT response back in the same conversation.
Install once on your Mac. Works instantly on your iPhone, iPad, and every Apple device signed into the same iCloud.
macOS 14.0+ • Python 3.9+ • Requires OpenAI API key
See it in action
36 seconds. Install to first AI reply.
Hey, what's the capital of Uruguay?
@capital of Uruguay
𝑇ℎ𝑒 𝑐𝑎𝑝𝑖𝑡𝑎𝑙 𝑜𝑓 𝑈𝑟𝑢𝑔𝑢𝑎𝑦 𝑖𝑠 𝑀𝑜𝑛𝑡𝑒𝑣𝑖𝑑𝑒𝑜. 𝐼𝑡'𝑠 𝑎𝑙𝑠𝑜 𝑡ℎ𝑒 𝑙𝑎𝑟𝑔𝑒𝑠𝑡 𝑐𝑖𝑡𝑦, ℎ𝑜𝑚𝑒 𝑡𝑜 𝑎𝑏𝑜𝑢𝑡 ℎ𝑎𝑙𝑓 𝑡ℎ𝑒 𝑐𝑜𝑢𝑛𝑡𝑟𝑦'𝑠 𝑝𝑜𝑝𝑢𝑙𝑎𝑡𝑖𝑜𝑛.
How It Works
Install on one Mac. Every device signed into the same iCloud account gets AI replies automatically.
Install
One Homebrew command. Or use the curl one-liner.
Setup
Run imessages-ai setup. Enter your OpenAI key.
Start
imessages-ai start. Runs in background, survives reboots.
Message
Type @anything in any iMessage. AI replies in-thread.
Features
One-Command Install
brew install maxawad/tap/imessages-ai — that's it. Setup wizard walks you through the rest.
Works in Any Chat
1-on-1, group chats, SMS, email-based iMessage. AI replies show up in the same thread.
Privacy First
Only triggers on messages YOU send starting with @. Other people's messages are never read.
Italic AI Replies
Responses in 𝑈𝑛𝑖𝑐𝑜𝑑𝑒 𝑖𝑡𝑎𝑙𝑖𝑐 so you can instantly tell AI apart from your own messages.
Fully Configurable
Pick your model (GPT-4o, GPT-4o-mini), trigger prefix, token limit, and more.
Background Service
Runs via launchd — auto-starts on login, stays alive, zero maintenance.
Coming Soon
What we're building next.
Conversation Memory
AI remembers the last few messages for context-aware follow-ups.
Image Understanding
Send a photo + @describe this. GPT-4o vision analyzes it inline.
Live Tools
@weather, @translate, @calc — real-time function calling with live data.
Multi-Model
@ for GPT-4o, @@ for Claude, @mini for fast answers. Pick per-question.
Custom Personas
@chef, @lawyer, @coder — load specialized system prompts on the fly.
Usage Dashboard
Track token spend, query history, and cost per day/week/month.
Built With
Open source. MIT licensed. Contributions welcome on GitHub.
Ready to try it?
Install iMessages AI and turn every conversation into a ChatGPT-powered assistant. One command, two minutes, all your devices.