imsg
iMessage/SMS CLI for listing chats, history, watch, and sending.
When & Why to Use This Skill
This Claude skill integrates the imsg CLI to enable seamless management of iMessage and SMS directly within your AI agent environment on macOS. It empowers users to list chats, retrieve message history, monitor incoming messages in real-time, and send text or file attachments, effectively bridging the gap between automated workflows and personal or professional messaging channels.
Use Cases
- Automated Notifications: Send real-time status updates, project alerts, or reminders to contacts via iMessage based on AI-driven task completions.
- Conversation Analysis: Retrieve and summarize long chat histories to extract key action items, sentiment, or specific information without manual scrolling.
- Interactive Workflows: Enable AI agents to request approvals or feedback from human stakeholders through standard SMS/iMessage channels.
- File Distribution: Automatically share AI-generated reports, images, or documents with specific recipients directly from the command line interface.
| name | imsg |
|---|---|
| description | iMessage/SMS CLI for listing chats, history, watch, and sending. |
| homepage | https://imsg.to |
| metadata | {"clawdbot":{"emoji":"📨","os":["darwin"],"requires":{"bins":["imsg"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/imsg","bins":["imsg"],"label":"Install imsg (brew)"}]}} |
imsg
Use imsg to read and send Messages.app iMessage/SMS on macOS.
Requirements
- Messages.app signed in
- Full Disk Access for your terminal
- Automation permission to control Messages.app (for sending)
Common commands
- List chats:
imsg chats --limit 10 --json - History:
imsg history --chat-id 1 --limit 20 --attachments --json - Watch:
imsg watch --chat-id 1 --attachments - Send:
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
Notes
--service imessage|sms|autocontrols delivery.- Confirm recipient + message before sending.