imsg

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

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/wuv-dreamguide/openclaw --skill imsg-wuv-dreamguide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/wuv-dreamguide/openclaw/tree/main/skills/imsg
Command: npx skills add https://github.com/wuv-dreamguide/openclaw --skill imsg-wuv-dreamguide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables you to read and send iMessages via macOS Messages.app from the terminal, reducing context switching and manual tapping.

Core Features & Use Cases

  • List chats and view chat IDs for quick reference.
  • View chat history and attachments.
  • Send messages to phone numbers or Apple IDs.
  • Optionally choose iMessage or SMS depending on recipient.

Quick Start

List chats with imsg chats and then send a message with imsg send --to "+15551234567" --text "Hello".

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessages from the macOS terminal?

To send iMessages from the macOS terminal, use the command imsg send --to "+15551234567" --text "Hello". This routes your text through the native Messages.app.

Can I view iMessage chat history in the command line?

Yes, you can view iMessage chat history in the command line. The imsg tool lets you list active chats, retrieve specific chat IDs, and view past message history directly in the terminal.

Does the imsg command line tool require special permissions on macOS?

Yes, the imsg command line tool requires macOS with Messages.app installed. You must also grant automation permissions to your terminal so the binary can control the app and send texts.

What is the best way to automate sending SMS to contacts from a Mac?

The best way to automate sending SMS to contacts from a Mac is using a CLI tool like imsg. It allows you to script message sending to phone numbers or Apple IDs, optionally choosing between iMessage or SMS.

How do I list all active iMessage chats from the terminal?

You can list all active iMessage chats from the terminal by running the command imsg chats. This provides a quick reference of your conversations and their associated chat IDs for further actions.