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.