imsg

Read and send iMessage/SMS via macOS Messages.app from the terminal.

2.8k|332|Updated Jan 29, 2026
One-click install
npx skills add https://github.com/moltis-org/moltis --skill imsg-moltis-org
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/moltis-org/moltis/tree/main/crates/skills/src/assets/messaging/imsg
Command: npx skills add https://github.com/moltis-org/moltis --skill imsg-moltis-org

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users who want to read iMessage conversations and send messages without leaving the terminal can use a CLI to interact with Messages.app.

Core Features & Use Cases

  • List chats and view recent conversations from the command line.
  • View conversation history and search for specific messages.
  • Send text messages to phone numbers or Apple IDs, with optional attachments.

Quick Start

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

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send an iMessage or SMS from the command line on macOS?

You can send an iMessage or SMS from the command line by invoking the imsg binary, which automates macOS Messages.app to compose and send texts to phone numbers or Apple IDs, including optional attachments.

Can I view iMessage conversation history from the terminal?

Yes, you can view iMessage conversation history from the terminal. The imsg CLI lists recent chats, reviews full conversation histories, and searches for specific messages directly within your macOS environment.

Do I need to grant automation permissions to read and send iMessage via CLI?

Yes, sending iMessage via CLI requires macOS with Messages.app signed in and appropriate automation permissions granted to allow the imsg binary to control the Messages application.

What is the best way to automate text messaging workflows on macOS without leaving the terminal?

The best way to automate text messaging workflows on macOS is using a CLI tool like imsg, which interfaces with Messages.app to list chats, read histories, and send messages for lightweight personal automation.

Why does my iMessage CLI automation fail to send messages?

iMessage CLI automation fails to send messages if Messages.app is not signed in on macOS, if appropriate automation permissions are missing, or if the imsg binary is not invoked correctly.