imessage

Send and receive iMessage and SMS messages from the macOS terminal.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the need to switch between your terminal and the macOS Messages app to send texts, check iMessage history, or respond to messages, letting you manage all your messaging directly from your command line workflow.

Core Features & Use Cases

  • Send iMessages/SMS: Send text messages and media attachments to phone numbers or Apple IDs directly from the terminal.
  • Read conversation history: Pull up recent iMessage chat logs, including attachment details, for any conversation.
  • Monitor incoming messages: Watch for new messages in specific chats in real time. Use case: If you are working in the terminal and need to quickly send a text to a colleague without switching apps, or pull up a recent message thread to reference a shared link, this Skill handles it natively.

Quick Start

Use the imessage skill to send a text message to the phone number +14155551212 saying "I'll be 5 minutes late to the meeting."

Frequently Asked Questions about imessage

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send iMessages directly from the macOS terminal?

You can send iMessages directly from the macOS terminal by using the imsg CLI to send texts and media attachments to phone numbers or Apple IDs without switching to the Messages app.

Can I retrieve iMessage chat history and attachment details via the command line?

Yes, you can retrieve iMessage chat history via the command line by pulling up recent conversation logs and full attachment metadata for any active chat using terminal commands.

Do I need to install Homebrew and grant Full Disk Access to use iMessage in the terminal?

Yes, you need to install the imsg CLI via Homebrew on macOS and grant Full Disk Access and Automation permissions to your terminal to access the Messages app database.

What is the best way to monitor incoming SMS messages in real time while coding?

The best way to monitor incoming SMS messages in real time while coding is using the terminal to watch for new messages in specific chats, keeping you in your workflow without app switching.

Does this command line messaging tool work with both iMessage and SMS protocols?

Yes, this command line messaging tool works with both iMessage and SMS protocols, allowing you to send and receive text messages and media attachments across both services natively.

Why are my terminal commands for reading iMessage chats not working on macOS?

Terminal commands for reading iMessage chats may not work if your macOS Messages app is not signed in, or if Full Disk Access and Automation permissions are not properly granted to the terminal.