imessage

Send and receive iMessages/SMS from the macOS terminal via imsg CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill allows you to send and receive iMessages/SMS from your macOS terminal, providing a convenient alternative to the native Messages.app interface.

Core Features & Use Cases

  • Send and Receive Messages: Interact with your iMessage and SMS conversations through the terminal.
  • Command Line Interface: Access your messaging features using simple command-line commands.
  • MacOS Exclusive: Specifically designed for macOS users, leveraging the Messages.app for message handling.

Quick Start

Use the imsg command to send a message. For example, send a message to +14155551212 with the text "Hello!" by running imsg send --to "+14155551212" --text "Hello!".

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 terminal on macOS?

To send iMessages from the terminal on macOS, use the `imsg` command with the recipient and text parameters, such as `imsg send --to "+14155551212" --text "Hello!"`. This interacts directly with the Messages.app service.

Can I receive SMS and iMessages through a command line interface?

Yes, you can receive SMS and iMessages through a command line interface. This Skill interacts with the macOS Messages.app service to access your messaging conversations directly within the terminal environment.

Do I need a specific CLI tool to use iMessage in the terminal?

Yes, you need to install the `imsg` CLI tool and grant appropriate permissions. This command line interface is required to interact with the macOS Messages.app service for sending and receiving messages.

Does this terminal messaging approach work on operating systems other than macOS?

No, this terminal messaging approach is exclusively designed for macOS. It relies specifically on the native Messages.app service to handle iMessage and SMS operations, making it incompatible with other operating systems.

What is the best way to automate sending SMS texts from a macOS command line?

The best way to automate sending SMS texts from a macOS command line is using the `imsg send` command. It interfaces with the Messages.app service to dispatch messages programmatically without opening the native application interface.

Why are my iMessage terminal commands not working?

iMessage terminal commands may not work if the `imsg` CLI is not installed or appropriate macOS permissions are not granted. The tool requires explicit access to interact with the Messages.app service for sending and receiving messages.