imessage

Send and receive iMessage/SMS messages via the imsg CLI on macOS.

9|3|Updated May 18, 2026

Search Tags:#messaging #CLI #macOS #iMessage #SMS

Ready to run

npx skills add https://github.com/jordanhubbard/mac --skill imessage-jordanhubbard

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/jordanhubbard/mac/tree/main/src/mac/_hermes/skills/apple/imessage
Command: npx skills add https://github.com/jordanhubbard/mac --skill imessage-jordanhubbard

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill addresses the need for a command-line interface to interact with iMessage/SMS, simplifying the process of sending and receiving messages on macOS.

Core Features & Use Cases

Send/Receive Messages: Send and receive iMessages/SMS directly from the command line.
Read Conversation History: Access and view iMessage conversation histories.
Check Chats: Review recent Messages.app chats.
Use Case: Need to send a quick message to a friend while multitasking on your computer? Use this Skill to send a message with the imsg send command.

Quick Start

Use the imsg send command to send an iMessage to your friend's phone number.

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

You can send iMessages from the macOS command line by executing the imsg send command with a recipient's phone number or Apple ID. This requires installing the imsg CLI and having Messages.app signed in on your macOS system.

Can I read iMessage conversation histories using a CLI on macOS?▼

Yes, you can read iMessage conversation histories using a CLI on macOS. The imsg CLI enables you to access and view past conversation histories directly from the terminal without opening the Messages.app interface.

Does sending and receiving SMS via the macOS CLI require Messages.app to be signed in?▼

Sending and receiving SMS via the macOS CLI does require Messages.app to be signed in. The imsg CLI tool acts as a command-line interface that interacts directly with the signed-in Messages.app on your macOS device.

What is the best way to check recent iMessage chats from the terminal?▼

The best way to check recent iMessage chats from the terminal is using the imsg CLI. It provides specific commands to review and list recent Messages.app chats directly within your macOS command-line environment.

What are the limitations of using a CLI for SMS messaging on macOS?▼

Limitations of using a CLI for SMS messaging on macOS include its dependency on the imsg tool and a signed-in Messages.app. It is designed for basic send, receive, and history reading tasks rather than advanced media handling.