imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Mac users want a programmable way to send and read iMessages/SMS from the command line or scripts without switching apps.

Core Features & Use Cases

  • Read chats and history from Messages.app and respond programmatically.
  • Send messages to phone numbers or Apple IDs, with optional attachments.
  • List chats, watch for new messages, and force service options when needed.

Quick Start

Send an iMessage to a contact using imsg on macOS.

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 command line on macOS?

You can send iMessages from the command line on macOS using the imsg CLI to programmatically send messages to phone numbers or Apple IDs, with optional attachments, without switching apps.

Can I read iMessage chat history programmatically?

Yes, you can read iMessage chat history programmatically by using the imsg CLI to list conversations and view chat history directly from the Messages app on macOS.

Do I need the Messages app signed in to use imsg for automation?

Yes, you need macOS with the Messages app signed in and the imsg CLI installed to automate personal messaging workflows like sending messages and reading chat history.

Is there a way to watch for new iMessages via a CLI tool?

Yes, the imsg CLI supports watching for new iMessages on macOS, allowing you to monitor incoming messages and apply automated workflows to personal messaging tasks.

What is the best way to automate SMS and iMessage workflows on macOS?

The best way to automate SMS and iMessage workflows on macOS is using the imsg CLI to send messages, list chats, and read history programmatically, bypassing manual app interaction.

Can I send attachments with iMessages using a command line script?

Yes, you can send attachments with iMessages using a command line script by utilizing the imsg CLI on macOS to programmatically send files to phone numbers or Apple IDs.