skills.rest
thisismynewfmail-ui
thisismynewfmail-uiCOMMUNITY
Explore all skills by this author →
GitHub

imessage

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

Updated Apr 12, 2026
Search Tags:#automation#cli#macos#messages#sms#imessage
One-click install
npx skills add https://github.com/thisismynewfmail-ui/Monika-agent --skill imessage-thisismynewfmail-ui
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/thisismynewfmail-ui/Monika-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/thisismynewfmail-ui/Monika-agent --skill imessage-thisismynewfmail-ui

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Users need a reliable way to automate sending and receiving iMessage or SMS messages on macOS without leaving the terminal, eliminating manual steps in the Messages app.

Core Features & Use Cases

  • Send messages: Compose and deliver iMessage or SMS directly via the imsg CLI.
  • Read history: Retrieve recent chat logs, list active conversations, and watch for new incoming messages.
  • Safety checks: Enforces confirmation of recipients and content, verifies file paths for attachments, and respects macOS privacy permissions.
  • Use case: Quickly notify a contact (“I’ll be late”) or fetch the last few messages from a chat without opening the GUI.

Quick Start

Ask Monika to send “I’ll be late” to Mom via iMessage.

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessage or SMS from the macOS terminal?▼

You can send iMessage or SMS from the macOS terminal using the imsg CLI tool. It automates message delivery directly through the Messages app, requiring macOS with Messages.app signed in and the imsg command installed via Homebrew.

Can I read iMessage chat history and list recent conversations via command line?▼

Yes, you can read iMessage chat history and list recent conversations via command line using the imsg CLI. It retrieves recent chat logs, lists active conversations, and watches for new incoming messages on the Messages app.

What macOS permissions are needed to automate text messages with imsg?▼

Automating text messages with imsg requires Full Disk Access and Automation permissions in macOS. You also need Messages.app signed in and the imsg command installed via Homebrew to ensure the CLI can interact with the Messages app properly.

Does sending SMS through the macOS command line require opening the Messages app?▼

No, sending SMS through the macOS command line does not require opening the Messages app GUI. The imsg CLI interacts with Messages.app in the background to deliver messages, read history, and watch for incoming texts directly from the terminal.

Are there safety checks when automating iMessage sending via CLI?▼

Yes, automating iMessage sending via CLI includes safety checks that enforce confirmation of recipients and message content. It also verifies file paths for attachments and respects macOS privacy permissions to prevent unintended message delivery.

Why is my imsg CLI not working on macOS?▼

Your imsg CLI may not be working because macOS lacks Full Disk Access or Automation permissions for the terminal. Ensure Messages.app is signed in, imsg is installed via Homebrew, and privacy settings grant the terminal access to the Messages app.

Related Skills

Explore More Content & Communication Skills→
afel6afel6

imessage

Send and receive iMessage and SMS messages via macOS Messages.app.

Community
Intermediate
psd401psd401
2

scope

Classify work scope into Small, Medium, or Large and route execution paths.

Official
Advanced
JuanMS20JuanMS20

automation

Orchestrate multi-step workflows with cron scheduling, subtask delegation, and logging.

Community
Intermediate
zerwizzerwiz

imessage

Send and receive iMessages or SMS via the macOS Messages.app command line.

Community
Intermediate