imessage

Send and receive iMessage and SMS messages via macOS CLI.

Updated May 8, 2026

Search Tags:#messaging #macOS #command line #iMessage #SMS

Ready to run

npx skills add https://github.com/gztcode/my-skills --skill imessage-gztcode

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/gztcode/my-skills/tree/main/imessage
Command: npx skills add https://github.com/gztcode/my-skills --skill imessage-gztcode

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill resolves the inconvenience of managing iMessages and SMS messages manually, allowing users to manage their messaging through the command line interface.

Core Features & Use Cases

Send and Receive Messages: Send and receive iMessages and SMS through macOS Messages.app using imsg commands.
View Conversation History: Retrieve the history of conversations or specific messages.
Customize Message Delivery: Send messages as iMessage or SMS directly from the command line.
Use Case: When you need to send a message to someone and quickly need confirmation that it was sent, using imsg can be more efficient than the standard macOS Messages.app.

Quick Start

Send an iMessage using the imsg command: imsg send --to "+14155551212" --text "Hello!" --service imessage.

Frequently Asked Questions about imessage

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

FAQPage Schema

How do I send an iMessage from the macOS command line?▼

You can send an iMessage from the macOS command line by executing the `imsg send` command with recipient and text parameters, bypassing the Messages app interface.

Can I retrieve SMS conversation history using terminal commands on macOS?▼

Yes, you can retrieve SMS conversation history using terminal commands on macOS. The CLI queries Messages.app data to fetch past conversations or specific message histories directly in your terminal.

Does command line messaging work without opening the Messages app?▼

Command line messaging operates via terminal commands but requires a macOS environment with Messages.app configured beforehand to successfully route and send your iMessages and SMS texts.

What is the best way to automate sending SMS texts on macOS?▼

Automating SMS texts on macOS is best achieved by running CLI commands that specify SMS as the service, allowing you to trigger message delivery directly from terminal scripts without manual app interaction.

Are there limitations to managing iMessages through a CLI?▼

A key limitation of managing iMessages through a CLI is the strict dependency on a macOS environment; the terminal scripts cannot execute or route messages without Messages.app configured on the host machine.