imessage

Send and manage iMessages and SMS conversations via the macOS Messages.app command-line interface.

Updated Feb 21, 2026

Search Tags:#automation #messaging #macos #sms #imessage #imsg

Ready to run

npx skills add https://github.com/Gitnapp/Skills --skill imessage-gitnapp

💬 Prompt for ChatGPT / Claude Chat▼

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies sending, receiving, and reviewing iMessage or SMS conversations on macOS by providing a reliable command-line workflow through imsg.

Core Features & Use Cases

Message Management: Read chat history, list conversations, and monitor new Messages.app activity.
Message Sending: Send iMessages or SMS messages with support for text and attachments while enforcing confirmation safeguards.
Use Case: When a user needs to notify a contact, review a recent conversation, or automate a Messages.app interaction on a Mac, this Skill provides the required workflow.

Quick Start

Use the imessage skill to send a text message to a contact after confirming the recipient and message content.

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

To send iMessages from a Mac command line, you can use a workflow that interfaces with the macOS Messages.app via the imsg CLI tool, requiring user confirmation before delivering text or attachments to contacts.

Can I retrieve chat history from Messages.app on macOS?▼

Yes, you can retrieve chat history from Messages.app on macOS by using a command-line workflow that reads and monitors conversation activity directly through the macOS Messages.app interface.

Does sending SMS messages through macOS require user confirmation?▼

Yes, sending SMS messages through macOS requires user confirmation to safeguard the workflow, ensuring you verify the recipient and message content before the imsg CLI tool executes the delivery.

What do I need to automate messaging on Apple devices?▼

To automate messaging on Apple devices, you need a Mac with macOS Messages.app access, the imsg CLI tool installed, and the necessary Full Disk Access permissions for the command-line interface to interact with your conversations.

Are there limitations to managing SMS conversations through a Mac CLI?▼

Managing SMS conversations through a Mac CLI is limited to macOS environments, as the workflow depends entirely on the local Messages.app and the imsg CLI tool to send texts, retrieve chat history, and deliver attachments.