imsg

Read and send iMessages or SMS via macOS Messages.app from the command line.

5|Updated Mar 17, 2026
One-click install
npx skills add https://github.com/p-sree-sai-pavan/P.A.R.K.E.R --skill imsg-p-sree-sai-pavan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/p-sree-sai-pavan/P.A.R.K.E.R/tree/main/gateway/skills/imsg
Command: npx skills add https://github.com/p-sree-sai-pavan/P.A.R.K.E.R --skill imsg-p-sree-sai-pavan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS command-line access to read conversations, list chats, and send messages via macOS Messages.app, reducing app-switching and manual tapping.

Core Features & Use Cases

  • List chats and view conversation history from the terminal
  • Send messages to contacts or numbers with safety prompts to confirm before sending
  • Switch between iMessage and SMS based on recipient preferences for reliable delivery

Quick Start

Ask imsg to list a chats, view history, and send a message to a contact.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessage or SMS from the command line on macOS?

You can send iMessage or SMS from the command line on macOS by using a tool that interfaces with the Messages.app. This allows you to send messages to contacts or numbers directly from the terminal, applying safety prompts to confirm recipient and content before delivery.

Can I read conversation history and list chats in macOS Messages from the terminal?

Yes, you can list chats and view conversation history in macOS Messages from the terminal. Command-line access to Messages.app enables you to read previous conversations without needing to open the application or manually tap through the interface.

Do I need to install any dependencies to control iMessage via the macOS terminal?

Yes, controlling iMessage via the terminal requires macOS with the Messages.app installed. You also need to install the specific imsg binary using the Homebrew package manager before you can execute messaging commands.

What is the best way to automate sending SMS text messages in macOS workflows?

The best way to automate sending SMS text messages in macOS workflows is using a command-line interface that connects to Messages.app. This approach reduces manual tapping and app-switching by allowing automated message delivery based on recipient preferences.

How does a command-line messaging tool handle switching between iMessage and SMS?

A command-line messaging tool switches between iMessage and SMS by evaluating recipient preferences within macOS Messages.app. This ensures reliable delivery by automatically routing the text through the correct protocol based on the contact's capabilities.

Are there safety checks to prevent sending iMessages to the wrong contact from the CLI?

Yes, proper safety checks are implemented to confirm both the recipient and the message content before sending iMessages from the CLI. This prevents accidental delivery by requiring verification prior to executing the send command.