imessage

Send and retrieve iMessage and SMS messages via the imsg CLI on macOS.

7|1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/paxlabs-inc/ion-agent --skill imessage-paxlabs-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/paxlabs-inc/ion-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/paxlabs-inc/ion-agent --skill imessage-paxlabs-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This Skill bridges the gap between your terminal and the macOS Messages application, allowing you to interact with your conversations without leaving your command-line environment.

Core Features & Use Cases

  • Message Management: Send and receive iMessages or SMS directly via the command line.
  • Conversation History: Retrieve and search through past chat logs with structured JSON output.
  • Use Case: Quickly send a status update to a contact or monitor incoming messages for specific keywords while working in a terminal-based development workflow.

Quick Start

Use the imessage skill to send a text message to a specific phone number with your desired content.

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?

This Skill facilitates sending iMessage or SMS from the macOS terminal by interacting with the Messages application programmatically, allowing you to specify phone numbers and content directly in your command-line workflow.

Can I retrieve past iMessage chat logs as structured data?

Yes, you can retrieve and search past conversation history, outputting structured JSON data for easy auditing and analysis of your iMessage and SMS logs directly from the terminal.

Do I need the imsg CLI tool to automate messaging workflows on macOS?

Yes, the imsg CLI tool is a required dependency for this Skill to function, alongside appropriate macOS system permissions, enabling automated sending and real-time monitoring of messages.

What are the limitations of monitoring incoming messages via the command line?

Monitoring incoming messages via the command line is limited to macOS systems and requires continuous system permissions, meaning it will not function if macOS privacy settings block terminal access to Messages.

Is terminal-based messaging a good fit for automated status updates?

Terminal-based messaging is well-suited for automated status updates, allowing developers to quickly send notifications or monitor for specific keywords without leaving a terminal-based development workflow.