imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the issue of manually sending and receiving iMessages on macOS by leveraging the imsg CLI, offering a streamlined way to manage messages directly from the terminal.

Core Features & Use Cases

  • Send and Receive iMessages: Use imsg to send messages to any Apple ID or phone number, with the option to choose between iMessage or SMS.
  • Read History: Quickly access and read through your iMessage history, with support for viewing attachments.
  • Message Management: Check recent conversations and send new messages without leaving the terminal.

Quick Start

Use the imsg send command to send a new message: 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 macOS terminal?

To send iMessages from the macOS terminal, use the imsg CLI command `imsg send` with the recipient's phone number or Apple ID and your text. This routes messages directly through the Messages.app on your Mac.

Can I read iMessage history and view attachments via command line?

Yes, you can read iMessage history and view attachments via command line. The imsg CLI allows you to quickly access and read through your past iMessage conversations directly within your terminal workflow.

Do I need to be signed into Messages.app to use command line messaging scripts?

Yes, you need Messages.app open with signed-in accounts to use command line messaging scripts. The imsg CLI relies on the macOS Messages.app environment to send and receive iMessages and SMS.

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

The best way to automate SMS sending on macOS is using the imsg CLI within your script automation. It integrates message management into your command-line workflow, allowing you to choose between iMessage or SMS for delivery.

Does the imsg CLI work with both iMessage and SMS protocols?

Yes, the imsg CLI works with both iMessage and SMS protocols. When sending messages to any phone number or Apple ID through Messages.app, you can specify whether to use iMessage or SMS for transmission.