imessage

Send and read iMessages and SMS on macOS via the imsg CLI.

Updated Apr 25, 2026
One-click install
npx skills add https://github.com/danmartinez78/echo-ghost-backup --skill imessage-danmartinez78
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/danmartinez78/echo-ghost-backup/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/danmartinez78/echo-ghost-backup --skill imessage-danmartinez78

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automate the sending and reading of iMessages and SMS on macOS using the imsg CLI, reducing manual messaging effort.

Core Features & Use Cases

  • Read and list conversations from Messages.app
  • Send text messages with or without attachments via imsg
  • View conversation history and manage messaging workflows from the command line
  • Use cases: automate alerts or reminders by messaging contacts

Quick Start

Install and sign in to Messages, then run imsg to list chats or send a message.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I automate sending iMessages from the command line on macOS?

You can automate sending iMessages on macOS by using the imsg CLI tool to send text messages and attachments directly from the command line. This requires the macOS Messages app to be signed in and the imsg tool installed via Homebrew.

Can I read and list my SMS and iMessage conversations using a CLI?

Yes, you can read and list your SMS and iMessage conversations using the imsg CLI on macOS. The tool allows you to view conversation history and manage messaging workflows from the command line without opening the Messages app.

Do I need to install Homebrew to use the imsg CLI for messaging automation?

Yes, you need Homebrew to install the imsg CLI tool required for messaging automation. You must also ensure the native macOS Messages app is signed in to your account so the CLI can send and receive texts.

What is the best way to send automated alerts and reminders via iMessage?

Using a CLI tool like imsg is an effective way to send automated alerts and reminders via iMessage. By integrating imsg into your scripts, you can programmatically message contacts with text or attachments when specific events occur.

Why does the imsg CLI fail to send messages on my Mac?

The imsg CLI will fail to send messages if the macOS Messages app is not signed in or if the imsg tool is not properly installed. Ensure your Messages app is actively logged in and verify the installation via Homebrew.