clawdbot

imsg

@clawdbot/imsg
clawdbot
2,354
337 forks
Updated 1/7/2026
View on GitHub

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

Installation

$skills install @clawdbot/imsg
Claude Code
Cursor
Copilot
Codex
Antigravity

Details

Pathskills/imsg/SKILL.md
Branchmain
Scoped Name@clawdbot/imsg

Usage

After installing, this skill will be available to your AI coding assistant.

Verify installation:

skills list

Skill Instructions


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|auto controls delivery.
  • Confirm recipient + message before sending.