| name | imsg |
| description | iMessage/SMS CLI for listing chats, history, watch, and sending. |
| homepage | https://imsg.to |
| metadata | {"nemo":{"emoji":"📨","os":["darwin"],"requires":{"bins":["imsg"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/imsg","bins":["imsg"],"label":"Install imsg (brew)"}]}} |
imsg Actions
Overview
Use imsg to read and send Messages.app iMessage/SMS on macOS.
Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.
Inputs to collect
- Recipient handle (phone/email) for
send
chatId for history/watch (from imsg chats --limit 10 --json)
text and optional file path for sends
Actions
List chats
imsg chats --limit 10 --json
Fetch chat history
imsg history --chat-id 1 --limit 20 --attachments --json
Watch a chat
imsg watch --chat-id 1 --attachments
Send a message
imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg
Notes
--service imessage|sms|auto controls delivery.
- Confirm recipient + message before sending.
Ideas to try
- Use
imsg chats --limit 10 --json to discover chat ids.
- Watch a high-signal chat to stream incoming messages.