imsg

Manage iMessage and SMS conversations from macOS command line via Messages.app automation.

Updated Jan 29, 2026

Search Tags:#messaging #communication #cli #macos #sms #imessage

Ready to run

npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill imsg-douglasjs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/douglasjs/clawdbot_plugin_tools/tree/main/imsg
Command: npx skills add https://github.com/douglasjs/clawdbot_plugin_tools --skill imsg-douglasjs

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill allows you to interact with your iMessage and SMS conversations directly from the command line on your macOS device, streamlining communication.

Core Features & Use Cases

List Chats: View your recent iMessage and SMS conversations.
View History: Retrieve message history for specific chats, including attachments.
Send Messages: Compose and send new iMessages or SMS messages, optionally with attachments.
Watch Conversations: Monitor conversations in real-time for new messages.

Quick Start

Use imsg to send a text message to your contact named 'Mom'.

Frequently Asked Questions about imsg

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I send and read iMessages from the command line on macOS?▼

Sending and reading iMessages via the command line on macOS requires Messages.app to be signed in, with Full Disk Access and Automation permissions granted to your terminal for managing conversations and attachments.

Can I monitor iMessage conversations in real-time through a terminal?▼

Monitoring iMessage conversations in real-time through a terminal requires Messages.app to be signed in, with Full Disk Access and Automation permissions granted to your terminal for managing conversations and attachments.

What macOS permissions do I need to send SMS messages from a CLI?▼

Sending SMS messages from a CLI requires Messages.app to be signed in, with Full Disk Access and Automation permissions granted to your terminal for managing conversations and attachments.

Does command-line iMessage management support retrieving attachments?▼

Retrieving attachments via command-line iMessage management requires Messages.app to be signed in, with Full Disk Access and Automation permissions granted to your terminal for managing conversations and attachments.

Why is my CLI unable to access iMessage chat history on macOS?▼

Accessing iMessage chat history on macOS via CLI requires Messages.app to be signed in, with Full Disk Access and Automation permissions granted to your terminal for managing conversations and attachments.