imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill simplifies sending and receiving iMessage/SMS through the imsg CLI, offering a convenient way to interact with Messages.app on macOS.

Core Features & Use Cases

  • Send and Receive Messages: Send text, images, and more through iMessage/SMS.
  • View Conversations: Read and manage conversation history.
  • Monitor Chats: Watch for new messages with optional attachment notifications.
  • Use Case: If you frequently send messages on your iPhone, but need a command-line interface, this Skill can streamline your workflow.

Quick Start

Use the imsg send --to "+14155551212" --text "Hello!" command to send a text message.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessage or SMS from the macOS command line?

To send iMessage or SMS from the macOS command line, use the imsg CLI to route text and attachments through the Messages.app. You can execute commands like `imsg send` with recipient numbers and text content directly in your terminal.

Can I view conversation history and monitor new messages via terminal?

Yes, you can view conversation history and monitor new messages via terminal using the imsg CLI. It allows you to read past chats and watch for incoming messages with optional attachment notifications directly on macOS.

Does the macOS iMessage CLI require Messages.app to be signed in?

Yes, using the iMessage CLI requires the Messages.app to be actively signed in on your macOS device. You also need to install the imsg CLI and grant appropriate system permissions for it to interact with the messaging app.

What is the best way to automate sending text messages on macOS?

The best way to automate sending text messages on macOS is using the imsg CLI to script interactions with Messages.app. This approach allows you to send iMessages and SMS programmatically, streamlining workflows for frequent messaging tasks.

Why is my iMessage CLI not sending messages on macOS?

If your iMessage CLI is not sending messages, it likely lacks appropriate system permissions or Messages.app is not signed in. The imsg CLI requires full disk access and an active Apple ID session within Messages.app to function properly.

Can I send images through the macOS terminal messaging tool?

Yes, you can send images through the macOS terminal messaging tool. The imsg CLI supports sending various attachments, including images, alongside standard text via iMessage or SMS through the Messages.app interface.