imessage

Read and send iMessages and SMS via the imsg CLI on macOS.

14|2|Updated Mar 29, 2026
One-click install
npx skills add https://github.com/gquthier/CLAWG --skill imessage-gquthier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/gquthier/CLAWG/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/gquthier/CLAWG --skill imessage-gquthier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and send iMessages and SMS from macOS using a CLI-driven workflow, reducing manual steps and context switching.

Core Features & Use Cases

  • Read chat history and list conversations from Messages.app
  • Send messages to phone numbers or Apple IDs with optional attachments
  • Automate quick messaging and simple workflows from the terminal

Quick Start

Install imsg on macOS, ensure Messages.app is signed in, and run a command to read 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 send iMessages from the macOS command line?

You can send iMessages from the macOS command line by using the imsg CLI to direct messages to phone numbers or Apple IDs, optionally including attachments, after Messages.app is signed in.

Can I read iMessage chat history using a CLI tool on macOS?

Yes, you can read iMessage chat history on macOS by running the imsg CLI to list active conversations and view past message logs directly within the Messages.app environment.

Do I need any specific setup to automate SMS messaging via the macOS terminal?

To automate SMS messaging via the macOS terminal, you need macOS with Messages.app signed in, the imsg tool installed, and necessary system permissions granted before executing send commands.

What is the best way to watch for new iMessages in an automated workflow?

The best way to watch for new iMessages in an automated workflow is using the imsg CLI's watch feature, which monitors Messages.app for incoming texts and reduces manual context switching.

Are there limitations when sending attachments through a command line messaging tool?

When sending attachments through the command line messaging tool, you must ensure input validation and safeguards are applied before sending to prevent errors in your macOS Messages.app workflow.