imsg

Read and send iMessage and SMS from the macOS command line.

1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/zhcndoc/openclaw --skill imsg-zhcndoc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/zhcndoc/openclaw/tree/main/skills/imsg
Command: npx skills add https://github.com/zhcndoc/openclaw --skill imsg-zhcndoc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS management and messaging via a simple macOS command-line interface, enabling quick reads and sends without switching apps.

Core Features & Use Cases

  • List chats and view history from Messages.app
  • Send text messages to phone numbers or Apple IDs
  • Read conversations and attach simple status updates in scripts

Quick Start

Send an iMessage or SMS to a contact from the terminal after confirming the recipient.

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 macOS command line?

You can send an iMessage or SMS from the macOS command line by using this Skill to automate the Messages app. It requires macOS with Messages.app signed in and automation permissions enabled to send texts to phone numbers or Apple IDs.

Can I read and list iMessage chat history from the terminal?

Yes, you can list chats and view conversation history directly from the terminal. This Skill automates reading Messages.app data, allowing you to retrieve chat logs without opening the GUI application.

Do I need to grant automation permissions to send text messages via macOS scripts?

Yes, sending text messages via macOS scripts requires automation permissions for the Messages app. The Skill outlines necessary security safeguards and requires Messages.app to be signed in on your macOS device.

What are the best ways to automate rapid replies and status updates for iMessage?

Automating rapid replies and status updates for iMessage is best handled by scripting the Messages app through the macOS command line. This Skill enables lightweight business workflows and automated reminders without switching applications.

Are there limitations when using CLI automation for SMS on macOS?

Limitations of CLI automation for SMS on macOS include dependency on Messages.app being signed in and requiring explicit automation permissions. It is designed for personal and lightweight business workflows rather than heavy-scale messaging.

Does this iMessage CLI tool work without the Messages app actively running?

This iMessage CLI tool relies on the macOS Messages app infrastructure and requires the account to be signed in. It automates the application layer, meaning the underlying Messages.app environment must be properly configured on macOS.