imessage

Send and receive iMessages and SMS on macOS via a CLI tool.

1.2k|116|Updated Mar 19, 2026

Search Tags:#messaging #macos #apple #messages #sms #imessage #imsg

Ready to run

npx skills add https://github.com/math-inc/OpenGauss --skill imessage-math-inc

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/math-inc/OpenGauss/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/math-inc/OpenGauss --skill imessage-math-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Quickly send and read iMessages and SMS on macOS without switching apps, enabling automation and lightweight messaging workflows.

Core Features & Use Cases

Send messages to iMessage or SMS from the command line.
Read chat history and list recent conversations to stay on top of messaging.
Minimal automation: integrate into scripts to trigger messages or respond to events.

Quick Start

Install imsg, then use imsg chats to view conversations and imsg send to message someone.

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 command line on macOS?▼

To send iMessages via the macOS command line, use the imsg CLI tool to validate recipients and dispatch texts without opening Messages.app. This enables quick, automated messaging directly from your terminal.

Can I read iMessage chat history using a CLI tool?▼

Yes, you can read iMessage chat history using the imsg CLI tool to list recent conversations and access message logs. This allows you to manage and review chats without launching the macOS Messages application.

Do I need any prerequisites to automate SMS messaging on macOS?▼

Yes, automating SMS messaging on macOS requires installing the imsg prerequisite package. Your system must also grant the necessary permissions to the CLI environment to validate recipients and dispatch messages on your behalf.

What is the best way to automate sending SMS without opening Messages.app?▼

The best way to automate sending SMS without opening Messages.app is integrating the imsg CLI tool into your scripts. This lightweight workflow triggers messages and responds to events by validating recipients through the command line.

Does sending iMessage via CLI work for automating event notifications?▼

Yes, sending iMessage via CLI works for automating event notifications by integrating the imsg command line tool into your existing scripts. This allows you to trigger quick messages automatically based on specific system events.