imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reading and sending iMessages and SMS from automation can be cumbersome; this Skill provides a CLI-based bridge to macOS Messages.app for programmatic messaging.

Core Features & Use Cases

  • Read recent chats and history from Messages.app.
  • Send text messages via the imsg CLI, with optional attachments.
  • Integrate iMessage workflows into scripts and automation pipelines on macOS.

Quick Start

Read your contacts and send a test message using the imsg CLI.

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 a script on macOS?▼

To send iMessages from a script on macOS, this Skill uses the imsg CLI to automate message dispatch through Messages.app, supporting text and attachments within workflows.

Can I read SMS conversation history programmatically on my Mac?▼

Yes, you can read SMS conversation history programmatically on macOS by using the imsg CLI to extract recent chats and history directly from the Messages.app database.

What do I need to automate text messaging via macOS Messages.app?▼

To automate text messaging via macOS Messages.app, you need a Mac with Messages.app signed in, the imsg CLI installed, and necessary permissions granted for reading chats and sending messages.

Does this approach support sending attachments with iMessage automation?▼

Yes, iMessage automation via the imsg CLI supports sending optional attachments alongside text messages, allowing programmatic outreach with rich media through Messages.app.

Why is my programmatic iMessage not working on macOS?▼

Programmatic iMessage automation fails if Messages.app is not signed in, the imsg CLI is missing, or macOS lacks the required permissions for reading chats and sending messages.