imsg

Read and send iMessage and SMS messages from the macOS terminal.

6|Updated Mar 13, 2026
One-click install
npx skills add https://github.com/me2Doc/friendlyclaw --skill imsg-me2doc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/me2Doc/friendlyclaw/tree/main/body/skills/imsg
Command: npx skills add https://github.com/me2Doc/friendlyclaw --skill imsg-me2doc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your terminal and macOS Messages.app, allowing you to read, search, and send messages without leaving your command-line workflow.

Core Features & Use Cases

  • Message Retrieval: Quickly list recent chats or pull specific conversation history with JSON output for easy parsing.
  • Direct Messaging: Send text messages or attachments to specific contacts or phone numbers directly from the terminal.
  • Real-time Monitoring: Watch for incoming messages in specific threads to stay updated on critical communications.

Quick Start

Use the imsg skill to send a text message to the contact with the phone number 555-0199 saying that you are running five minutes late.

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 texts from the macOS terminal?

To send iMessage or SMS texts from the macOS terminal, use this skill to programmatically direct messaging workflows to specific contacts or phone numbers. It bridges terminal commands with the Messages.app to send texts and attachments.

Can I retrieve and parse iMessage chat history via command line?

Yes, you can retrieve and parse iMessage chat history via command line. This skill lists recent chats and pulls specific conversation histories, outputting the messaging data in JSON format for easy parsing and integration.

Do I need special permissions to automate macOS Messages.app via CLI?

Yes, automating macOS Messages.app via CLI requires active macOS Messages.app permissions and the imsg binary. You must grant the necessary system access for the tool to read and send communications successfully.

What is the best way to monitor incoming SMS messages for terminal automation?

The best way to monitor incoming SMS messages for terminal automation is using this skill's real-time monitoring feature. It watches specific message threads to keep your command-line workflows updated on critical communications.

Does CLI messaging support sending attachments to contacts?

Yes, CLI messaging supports sending attachments to contacts. Beyond plain text messages, this skill enables you to send files directly to specific contacts or phone numbers from your terminal environment.

Why is my iMessage CLI automation not working on macOS?

Your iMessage CLI automation may not be working due to missing macOS Messages.app permissions or an absent imsg binary. This skill specifically requires both prerequisites to facilitate programmatic messaging correctly.