skills.rest
Lento47
Lento47COMMUNITY
Explore all skills by this author →
GitHub

imessage

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

1|Updated Jun 19, 2026
Search Tags:#messaging#cli#macos#sms#imessage#imsg#send text
One-click install
npx skills add https://github.com/Lento47/arcana-community --skill imessage-lento47
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Lento47/arcana-community/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Lento47/arcana-community --skill imessage-lento47

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve? It lets an AI agent read chat history and send iMessage or SMS texts through macOS Messages.app without manual interaction with the Messages UI. ## Core Features & Use Cases - List and Inspect Chats: Enumerate recent conversations with imsg chats and view message history by chat ID, including attachment info. - Send Messages with Attachments: Deliver text and files to phone numbers or Apple IDs, with control over iMessage vs SMS delivery via the --service flag. - Watch for Incoming Messages: Monitor a conversation in real time using imsg watch. - Use Case: A user says "Text mom that I'll be late" — the agent finds Mom's chat, confirms the recipient and content, then sends the message via imsg send. ## Quick Start Ask the agent to send an iMessage saying "Running 10 minutes late" to a specific contact, and it will locate the chat, confirm the details with you, and send it.

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: run `imsg send --to "+14155551212" --text "Hello!"` to send a message. Add `--file /path/to/image.jpg` to include an attachment, or `--service imessage` / `--service sms` to force a delivery method.

How do I read iMessage history from the terminal?▼

Run `imsg chats --limit 10 --json` to list recent conversations, then `imsg history --chat-id <id> --limit 20 --json` to view messages in a specific chat. Add `--attachments` to include attachment information.

What permissions does imsg need on macOS?▼

imsg requires macOS with Messages.app signed in, Full Disk Access granted to your terminal in System Settings under Privacy, and Automation permission for Messages.app, which macOS prompts for on first use.

Can imsg send SMS instead of iMessage?▼

Yes, pass `--service sms` to force SMS delivery or `--service imessage` to force iMessage. The default `--service auto` lets Messages.app decide based on the recipient's capabilities.

What are the limitations of sending messages with imsg?▼

imsg only works on macOS with Messages.app configured, and it does not support group chat management such as adding or removing members. Bulk messaging is discouraged and should always be confirmed with the user first.

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
api-evangelistapi-evangelist

notes-and-tasks

Manage record activities, to-dos, and timelines via the Frontline CLI.

Official
Intermediate
1mancompany1mancompany
380

Multi-Channel Communications

Route and manage messages across twenty-plus platforms via an OpenClaw gateway.

Official
Advanced
ToqsickToqsick

messaging-gateway-setup

Configure messaging platforms via Hermes gateway with bot creation and token management.

Community
Intermediate