imessage

Send iMessages and SMS from macOS via the imsg CLI.

97|8|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/peteromallet/megaplan --skill imessage-peteromallet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/peteromallet/megaplan/tree/main/megaplan/agent/skills/apple/imessage
Command: npx skills add https://github.com/peteromallet/megaplan --skill imessage-peteromallet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS users can manage iMessage and SMS from the command line, removing the need to switch apps for routine messaging tasks.

Core Features & Use Cases

  • Send Messages: Dispatch iMessages or SMS to contacts directly from scripts.
  • Read History: Retrieve recent conversations and chat histories from Messages.app.
  • Automation Friendly: Integrates into shell workflows to support alerts, reminders, and status updates.

Quick Start

Install imsg via Homebrew, grant the required permissions, and begin sending or reading iMessages from the CLI.

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 a macOS shell script?

To read iMessage conversation history via CLI, use the imsg tool to retrieve recent conversations and chat histories directly from the Messages.app database on your macOS system.

Do I need Homebrew to automate SMS messaging on macOS?

Yes, you can integrate iMessage automation into shell workflows to support scripted alerts, reminders, and status updates without needing to switch to the Messages.app manually.

What macOS permissions are required to control Messages.app from the command line?

Controlling Messages.app from the command line requires macOS permissions for Full Disk Access and Automation to be explicitly granted to the terminal or script environment executing the imsg commands.

How do I retrieve iMessage chat history from the command line?

To read iMessage conversation history via CLI, use the imsg tool to retrieve recent conversations and chat histories directly from the Messages.app database on your macOS system.