imsg

Read and send iMessage/SMS messages from the macOS terminal.

1|Updated Jan 28, 2026
One-click install
npx skills add https://github.com/Zentin-L/Masterbot --skill imsg-zentin-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/Zentin-L/Masterbot/tree/main/skills/imsg
Command: npx skills add https://github.com/Zentin-L/Masterbot --skill imsg-zentin-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users who rely on iMessage/SMS often need to manage conversations without switching apps; this Skill provides a command-line interface to read, list, and send messages efficiently.

Core Features & Use Cases

  • List chats: view conversations from the terminal.
  • History retrieval: fetch messages for a chat for auditing or reference.
  • Watch: monitor new messages as they arrive.
  • Send: compose and deliver messages to contacts via iMessage or SMS.

Quick Start

Run imsg to list chats, view history, and send a message from the terminal.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessage or SMS from the macOS terminal?

You can send iMessage or SMS from the macOS terminal by running the imsg command-line tool to compose and deliver messages directly to contacts without switching applications.

Can I list and fetch iMessage chat history using a CLI tool?

Yes, you can list active chats and retrieve message history using the imsg CLI tool, which fetches conversation logs from the Messages.app database for terminal-based auditing or reference.

Does reading and sending iMessages from the command line require Full Disk Access?

Yes, sending and reading iMessages from the command line requires macOS terminal automation permissions and Messages.app access to interact with the system messaging database securely.

How do I monitor new iMessage conversations in real-time from the terminal?

You can monitor new iMessage conversations in real-time by using the watch feature in the imsg CLI tool, which tracks and displays incoming messages as they arrive in your terminal.

What is the best way to automate SMS sending on macOS without AppleScript?

Using a dedicated CLI tool like imsg is an efficient way to automate SMS sending on macOS, bypassing complex AppleScripts by directly executing terminal commands to manage message delivery.

Are there limitations to sending SMS via the macOS terminal?

The primary limitation of sending SMS via the macOS terminal is that it requires a Mac connected to an iPhone with Text Message Forwarding enabled, as standard iMessage routing requires active Apple ID synchronization.