skills.rest
jakubbartnik
jakubbartnikCOMMUNITY
Explore all skills by this author →
GitHub

imessage

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

Updated Aug 19, 2026
Search Tags:#messaging#cli#macos#sms#imessage#imsg#send text
One-click install
npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill imessage-jakubbartnik
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/jakubbartnik/honey-barrel-finale/tree/main/honey-barrel-finale/workspace/hermes/skills/apple/imessage
Command: npx skills add https://github.com/jakubbartnik/honey-barrel-finale --skill imessage-jakubbartnik

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you send, read, and monitor iMessage and SMS conversations on macOS directly from the command line, without manually opening Messages.app. ## Core Features & Use Cases - Send Messages: Deliver text and file attachments to phone numbers or Apple IDs, with control over iMessage versus SMS delivery. - Read History: List recent chats and retrieve conversation history with optional attachment metadata in JSON format. - Watch for Replies: Monitor a specific chat for incoming messages in real time. - Use Case: A user asks to text a family member; the assistant finds the contact's chat, confirms the recipient and message content, then sends the iMessage via the imsg CLI. ## Quick Start Ask the assistant to send an iMessage saying you will be late to a specific contact, and confirm the recipient and text before it is sent.

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

Use the imsg CLI with the send command, specifying the recipient phone number or Apple ID and the message text. You can attach files with the file flag and force iMessage or SMS delivery with the service flag.

How do I read iMessage history from the terminal?▼

Run imsg chats to list recent conversations, then use imsg history with a chat ID to retrieve messages. Adding the json flag returns structured output, and the attachments flag includes file metadata.

What permissions does imsg need on macOS?▼

The terminal needs Full Disk Access granted in System Settings under Privacy, plus Automation permission for Messages.app when prompted. Messages.app must also be signed in with an Apple ID.

Can I force SMS instead of iMessage when sending a text?▼

Yes, pass the service flag with the value sms to force SMS delivery, or imessage to force iMessage. The default auto mode lets Messages.app decide based on the recipient.

What are the limitations of sending iMessages via CLI?▼

Group chat management such as adding or removing members is not supported, and bulk messaging is discouraged. The tool only works on macOS with Messages.app configured and cannot run on other platforms.

Related Skills

Explore More Personal & Entrepreneur Skills→
i-bebsii-bebsi

imessage

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

Community
Basic
FlexasaurusrexFlexasaurusrex
16

crmpaw

Manage client relationships and track sales pipelines within Telegram.

Community
Intermediate
obulaiobulai
1

obul-tomba

Find and verify emails and phone numbers via the Obul API.

Official
Intermediate
TheophilusChinomonaTheophilusChinomona
2

openclaw-channels

Configure messaging channel integrations for the OpenClaw AI gateway.

Community
Intermediate