imessage

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

Updated May 2, 2026
One-click install
npx skills add https://github.com/AlvaroBiano/hermes-agent --skill imessage-alvarobiano
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/AlvaroBiano/hermes-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/AlvaroBiano/hermes-agent --skill imessage-alvarobiano

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mac users who want to control Messages.app from the command line can read chats and send iMessages or SMS via a lightweight CLI.

Core Features & Use Cases

  • Read recent conversations and message history from Messages.app
  • Send iMessages or SMS to contacts or Apple IDs via the imsg CLI
  • Automate messaging workflows in scripts or assistants

Quick Start

Send an iMessage to a contact using imsg.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send and read iMessages from the command line on macOS?

The imsg CLI reads chat histories and sends iMessages or SMS by automating Messages.app on macOS, streamlining communications through command-line scripts and assistants.

Can I automate SMS and iMessage workflows in scripts without opening the Messages app?

You can automate SMS and iMessage workflows via the imsg CLI, which controls Messages.app in the background to send messages to contacts or Apple IDs without opening the application directly.

What do I need to set up before using the imsg CLI to send iMessages?

Before sending iMessages via the imsg CLI, you need macOS with Messages.app signed in, the imsg tool installed, and necessary permissions granted to access Messages.app and automate tasks.

Does this iMessage automation method work on operating systems other than macOS?

No, this iMessage automation method requires macOS with Messages.app signed in. It relies on macOS-specific permissions and the imsg CLI to read chats and send messages.

What is the best way to read recent chat history from Messages.app for automation?

The best way to read recent chat history for automation is using the imsg CLI, which retrieves recent conversations and message histories directly from Messages.app for your scripts.

Are there limitations when sending SMS to contacts via the imsg CLI?

Limitations include requiring necessary permissions to access Messages.app, needing macOS with the application signed in, and having the imsg CLI installed to properly automate SMS sending tasks.