imessage

Send and read iMessages on macOS via the imsg CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables programmatic sending and reading of iMessages and SMS on macOS through the imsg CLI, streamlining messaging workflows and automation.

Core Features & Use Cases

  • Read iMessage conversations and list chats from the Messages app.
  • Send messages to phone numbers or Apple IDs via the imsg CLI.
  • Archive and review recent conversations and attachments for automation tasks.

Quick Start

Send an iMessage to a specified contact using the imsg CLI on macOS after confirming the recipient and 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 iMessage texts from a script on macOS?

Send iMessages programmatically on macOS by invoking the imsg CLI within your automation scripts. This tool enables script-based message delivery to phone numbers or Apple IDs after confirming recipient details.

Can I read iMessage chat history and list conversations from the command line?

List and read iMessage chat history directly from the command line using the imsg CLI on macOS. This approach lets you archive and review recent conversations and attachments for automation tasks.

Does iMessage automation require the Messages app to be signed in?

iMessage automation requires the macOS Messages app to be signed in and properly configured with granted permissions. The imsg CLI relies on this active app environment to send and read messages successfully.

What's the best way to send automated text messages to Apple IDs on a Mac?

Automate text message delivery to Apple IDs on a Mac by executing the imsg CLI tool within your scripts. This method leverages the native macOS Messages app infrastructure to handle the actual message routing.

Why does my macOS messaging script fail to send iMessages via the command line?

macOS messaging scripts fail to send iMessages when the Messages app lacks proper sign-in or required system permissions. Ensure the Messages app is fully configured and granted access before running the imsg CLI.