imsg

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

⭐3.1kstars🔀474forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

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.
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.