skills.rest
MarbleSodas
MarbleSodasCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

imessage

Send and receive iMessages and SMS via the imsg command-line tool on macOS.

Updated Apr 9, 2026
Search Tags:#messaging#macos#chat history#attachments#sms#imessage#terminal automation
One-click install
npx skills add https://github.com/MarbleSodas/Mavis --skill imessage-marblesodas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/MarbleSodas/Mavis/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/MarbleSodas/Mavis --skill imessage-marblesodas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the friction of manually opening Messages.app to send texts or review recent conversation history by providing a terminal-first workflow for iMessage and SMS on macOS.

Core Features & Use Cases

  • Send iMessages and SMS: Compose and deliver messages to phone numbers or Apple IDs, optionally forcing iMessage vs SMS and attaching files.
  • Read conversation history: List chats and fetch message history for a specific chat ID, including optional attachment metadata.
  • Watch for new messages: Monitor a chat for incoming messages and surface attachment details when they arrive.

For example, when you need to tell someone you will be late, you can quickly locate the correct chat and send a confirmed message without leaving your current workflow.

Quick Start

Send the text "I'll be late" to +14155551212 over iMessage after confirming the recipient and message content.

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?▼

You can send iMessages from the macOS terminal by using the imsg command-line tool to compose and deliver texts to phone numbers or Apple IDs, optionally forcing iMessage versus SMS and attaching files.

Can I retrieve iMessage chat history with attachment metadata via CLI?▼

Yes, you can retrieve iMessage chat history via CLI by listing chats and fetching message history for a specific chat ID, which includes optional attachment metadata for reviewed conversations.

Do I need special macOS permissions to automate SMS and iMessage workflows?▼

Yes, automating SMS and iMessage workflows requires macOS Messages.app to be signed in, alongside appropriate Full Disk Access and Automation permissions, to ensure deterministic operation.

How do I monitor a specific chat for incoming SMS messages in real time?▼

You can monitor a specific chat for incoming SMS messages in real time by using the message watching feature to surface new messages and their attachment details as they arrive.

What is the best way to read and send texts without opening Messages.app on macOS?▼

The best way to read and send texts without opening Messages.app on macOS is using a terminal-first workflow via the imsg CLI to locate chats, view history, and deliver confirmed messages.

Related Skills

Explore More Content & Communication Skills→
kaminocorpkaminocorp
228

imessage

Send and read iMessages on macOS via the imsg CLI.

Official
Intermediate
jaredcroxtonjaredcroxton

imessage

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

Community
Intermediate
JKhyroJKhyro

imessage

Send and receive iMessages and SMS messages through macOS Messages.app.

Community
Intermediate
steipetesteipete
385.7k

imsg

Read and send iMessage/SMS conversations on macOS via a CLI tool.

Community
Intermediate