imessage

Send and read iMessages and SMS via the imsg CLI on macOS.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables macOS users to send and receive iMessages and SMS through a simple CLI interface, removing the friction of switching apps.

Core Features & Use Cases

  • One-click messaging: Send iMessages or SMS to contacts from a script or prompt.
  • History access: Retrieve recent chat history to reference prior messages.
  • Watch for new messages: Monitor conversations for incoming messages and respond programmatically.

Quick Start

Send a test iMessage to a contact using the imsg 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 command line script on macOS?

To send iMessages from a command line script on macOS, you can use the imsg CLI to compose and dispatch messages programmatically. The interface includes input validation and requires explicit user confirmation before sending.

Can I retrieve chat history for SMS and iMessage conversations without opening the app?

Yes, you can retrieve SMS and iMessage chat history without opening the app by executing CLI commands. This allows you to programmatically access recent conversation logs and reference prior messages directly in your terminal.

Does this iMessage CLI tool work for monitoring incoming messages in real time?

Yes, the iMessage CLI works for monitoring incoming messages by watching conversations for new activity. This enables automated workflows to detect incoming SMS or iMessages and respond programmatically without manual app interaction.

What are the prerequisites for using a CLI to send iMessages on macOS?

The prerequisite for using a CLI to send iMessages on macOS is having the imsg CLI installed on your system. You also need an active macOS environment configured to handle SMS and iMessage routing.

Are there safeguards to prevent sending iMessages to the wrong contacts via automation?

Yes, there are safeguards to prevent sending iMessages to wrong contacts via automation. The CLI implements explicit user confirmation prompts and input validation checks before any message dispatch occurs.

Can I automate SMS workflows without switching to the Messages app?

You can automate SMS workflows without switching to the Messages app by running imsg CLI commands. This removes the friction of app switching and allows you to handle sending, reading, and watching messages entirely through prompts or scripts.