iMessage/SMS CLI for listing chats, history, watch, and sending.
Downloads
3.5k
Stars
9
Versions
1
Updated
2026-02-23
Install
npx clawhub@latest install imsg
Documentation
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.
Launch an agent with Imsg on Termo.