imsg

iMessage/SMS CLI for listing chats, history, watch, and sending.

⭐430stars🔀44forks📁View on GitHub🕐Updated Dec 21, 2025⬇️4downloads

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.
nameimsg
descriptioniMessage/SMS CLI for listing chats, history, watch, and sending.
homepagehttps://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|auto controls delivery.
  • Confirm recipient + message before sending.