imessage

Send and receive iMessages and SMS from macOS via the imsg CLI.

1|1|Updated May 25, 2026
One-click install
npx skills add https://github.com/aayushsoam/clawbot-agent --skill imessage-aayushsoam
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/aayushsoam/clawbot-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/aayushsoam/clawbot-agent --skill imessage-aayushsoam

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

This Skill provides a command-line interface to manage iMessages and SMS directly from macOS, allowing for efficient messaging management without the need for the native Messages.app.

Core Features & Use Cases

  • Send and Receive Messages: Compose and send iMessages and SMS from the terminal.
  • View Chat History: Access the conversation history for any chat.
  • Send Attachments: Attach files to messages sent via iMessage or SMS.
  • Use Case: Use this Skill to send a text message to a contact's phone number while you're working in a terminal.

Quick Start

Use the imsg command to send an iMessage to +14155551212 with the text "Hello!".

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

Yes, you can send iMessages and SMS directly from the macOS terminal using the imsg CLI. This Skill provides command-line functionality to compose and send messages without opening the Messages.app.

Can I view SMS and iMessage chat history in the terminal?

Yes, you can access and view your SMS and iMessage chat history directly in the terminal. The imsg CLI retrieves conversation histories for any chat without needing the native Messages.app.

How do I send file attachments with iMessage using a command line tool?

To send file attachments via iMessage, use the imsg command line tool to attach files to your messages. This allows you to include documents or media when sending SMS and iMessages from macOS.

Do I need Messages.app installed to send SMS from the macOS terminal?

You need macOS with proper authorization to access Messages.app data, but you do not need to open the app itself. The imsg CLI requires this underlying macOS setup to send and receive SMS from the terminal.

What are the limitations of managing iMessages through a CLI instead of Messages.app?

Managing iMessages through a CLI limits you to text and attachment-based interactions without the native GUI's rich media features. It requires the imsg tool installation and proper macOS authorization to access Messages.app data.