skills.rest
freire19
freire19COMMUNITY
Explore all skills by this author →
GitHub

imsg

List chats, retrieve history, and send messages via macOS Messages.app.

Updated May 8, 2026
Search Tags:#automation#cli#macos#attachments#sms#imessage#message history
One-click install
npx skills add https://github.com/freire19/Mythos --skill imsg-freire19
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/freire19/Mythos/tree/main/skills/imsg
Command: npx skills add https://github.com/freire19/Mythos --skill imsg-freire19

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you list iMessage/SMS conversations, review message history, and send new texts without manually operating the Messages.app UI on macOS.

Core Features & Use Cases

  • Chat listing & history lookup: Find recent chats and pull message history by chat ID, including optional attachment metadata.
  • Sending iMessage/SMS: Send messages to phone numbers or Apple IDs with support for forcing iMessage or SMS and attaching files.
  • Monitoring incoming messages: Watch a chat for new messages and react when new content arrives.

Quick Start

Send an iMessage by asking your agent to find the recipient you want and then run imsg send to the specified phone number with the exact text you want to deliver.

Frequently Asked Questions about imsg

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

To send an iMessage via the command line on macOS, this Skill automates Messages.app to dispatch texts to a phone number or Apple ID. It allows forcing iMessage or SMS formats and attaching files directly from the terminal.

Can I retrieve iMessage chat history and attachment metadata programmatically?▼

Yes, you can retrieve iMessage chat history programmatically. This Skill lists recent chats and pulls conversation history by chat ID, including optional attachment metadata, by reading the macOS Messages database via the imsg CLI.

Do I need Full Disk Access to automate Messages.app on macOS?▼

Yes, Full Disk Access is required to automate Messages.app on macOS. This Skill requires Full Disk Access and Messages.app automation permissions to read the message database and send outbound texts through the imsg CLI.

What's the best way to monitor incoming SMS messages for new content?▼

The best way to monitor incoming SMS messages for new content is using this Skill to watch a specific chat ID. It monitors new inbound iMessage and SMS messages, allowing you to react programmatically when new content arrives in the conversation.

How do I attach a file when sending an iMessage via CLI automation?▼

To attach a file when sending an iMessage via CLI automation, you use this Skill's outbound message function which supports optional file attachments. You provide the recipient details and the file path to deliver the message through macOS Messages.app.

Related Skills

Explore More Personal & Entrepreneur Skills→
peteromalletpeteromallet
97

imessage

Send iMessages and SMS from macOS via the imsg CLI.

Community
Intermediate
ElbertePlinioElbertePlinio

session-navigation

Locate, search and retrieve historical Droid session data from local directories.

Community
Intermediate
kcns008kcns008
5

imsg

List and send iMessage and SMS conversations from macOS Messages.app.

Community
Intermediate
richardnguyen0715richardnguyen0715

imessage

Send and receive iMessages/SMS via the macOS command line using imsg.

Community
Intermediate