imsg
iMessage/SMS CLI for listing chats, history, watch, and sending.
When & Why to Use This Skill
The imsg Claude skill provides a powerful command-line interface (CLI) for managing iMessage and SMS directly on macOS. It enables Claude to list active chats, retrieve detailed message history with attachments, monitor incoming messages in real-time, and send texts or files. This skill effectively bridges the gap between AI-driven workflows and native Apple messaging, allowing for seamless communication automation and message management without leaving the terminal or AI environment.
Use Cases
- Automated Notifications: Send automated project updates, system alerts, or reminders to team members via iMessage directly from your AI workflow.
- Message Archiving and Summarization: Retrieve chat histories and use Claude to summarize long conversations, extract action items, or archive important information.
- Real-time Monitoring: Utilize the 'watch' command to monitor incoming messages for specific keywords or urgent client requests, enabling immediate AI-assisted responses.
- File and Media Distribution: Streamline the process of sending documents, images, or logs from your local machine to contacts using the CLI's file attachment capabilities.
| 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.