imessage

Name: imessage
Availability: InStock
Author: thisismynewfmail-ui

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

Ready to run

npx skills add https://github.com/thisismynewfmail-ui/Monika-agent --skill imessage-thisismynewfmail-ui

💬 Prompt for ChatGPT / Claude Chat▼

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.