skills.rest
gztcode
gztcodeCOMMUNITY
Explore all skills by this author →
GitHub

imessage

Send and receive iMessage and SMS messages via macOS CLI.

Updated May 8, 2026
Search Tags:#messaging#macOS#command line#iMessage#SMS
One-click install
npx skills add https://github.com/gztcode/my-skills --skill imessage-gztcode
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
JnusoJnuso

imsg

Read and send iMessage/SMS from macOS Messages.app via the CLI.

Community
Intermediate
keshav55keshav55

email-agent

Manage Gmail via AtrisOS to read, send, and archive emails.

Community
Intermediate
fufuonlinefufuonline

imsg

List, view, watch, and send iMessage conversations via the imsg CLI on macOS.

Community
Intermediate
agentic-inagentic-in
577

iMessage

Read Messages.app conversations and send messages via CLI or AppleScript with confirmation.

Official
Intermediate