imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a convenient way to interact with iMessages and SMS through the command line interface on macOS, simplifying the process of messaging without needing to switch to the Messages.app.

Core Features & Use Cases

  • Send Messages: Send iMessages and SMS text messages.
  • Read History: Retrieve and view iMessage and SMS conversation history.
  • Service Options: Choose to send messages via iMessage, SMS, or let Messages.app decide automatically.
  • Use Case: Ideal for automating messages for repetitive tasks, like reminders or scheduled communications.

Quick Start

Send an iMessage to +14155551212 with the text "Hello!" using 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 iMessage or SMS texts from the macOS command line?

You can send iMessage or SMS texts from the macOS command line by using the 'imsg' CLI tool to interact directly with the Messages.app, specifying the recipient and message text.

Can I retrieve iMessage conversation history using terminal commands?

Yes, you can retrieve and view iMessage and SMS conversation history using terminal commands by querying the Messages.app database through the 'imsg' command-line interface.

Does sending iMessages via the command line require an Apple ID?

Yes, sending iMessages via the command line requires an Apple ID because the tool interacts directly with the macOS Messages.app, which must be signed in to route messages.

Can I choose between iMessage and SMS when sending messages from the terminal?

Yes, you can choose between iMessage and SMS when sending messages from the terminal by specifying the service option, or you can let the Messages.app decide the routing automatically.

What is the best way to automate repetitive SMS reminders on macOS?

Automating repetitive SMS reminders on macOS is best achieved by scripting the 'imsg' CLI tool, which sends scheduled messages through the Messages.app without manual GUI interaction.

Why do I need the imsg tool to send iMessages from the terminal?

You need the 'imsg' tool because it acts as the command-line bridge to the macOS Messages.app, providing the necessary interface to send and receive texts without opening the application.