imsg

imsg

Use imsg to read and send iMessage/SMS via macOS Messages.app.

When to Use

✅ USE this skill when:

• User explicitly asks to send iMessage or SMS
• Reading iMessage conversation history
• Checking recent Messages.app chats
• Sending to phone numbers or Apple IDs

When NOT to Use

❌ DON'T use this skill when:

• Telegram messages → use message tool with channel:telegram
• Signal messages → use Signal channel if configured
• WhatsApp messages → use WhatsApp channel if configured
• Discord messages → use message tool with channel:discord
• Slack messages → use slack skill
• Group chat management (adding/removing members) → not supported
• Bulk/mass messaging → always confirm with user first
• Replying in current conversation → just reply normally (Clawdbot routes automatically)

Requirements

• macOS with Messages.app signed in
• Full Disk Access for terminal
• Automation permission for Messages.app (for sending)

Common Commands

List Chats

imsg chats --limit 10 --json

View History

# By chat ID
imsg history --chat-id 1 --limit 20 --json
 
# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json

Watch for New Messages

Send Messages

Service Options

• --service imessage — Force iMessage (requires recipient has iMessage)
• --service sms — Force SMS (green bubble)
• --service auto — Let Messages.app decide (default)

Safety Rules

1. Always confirm recipient and message content before sending
2. Never send to unknown numbers without explicit user approval
3. Be careful with attachments — confirm file path exists
4. Rate limit yourself — don't spam

Example Workflow

User: "Text mom that I'll be late"