imsg

Manage iMessage and SMS conversations from the macOS command line.

Updated Feb 18, 2026
One-click install
npx skills add https://github.com/loveoplay2023-hue/OpenMehdi --skill imsg-loveoplay2023-hue
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/loveoplay2023-hue/OpenMehdi/tree/main/skills/imsg
Command: npx skills add https://github.com/loveoplay2023-hue/OpenMehdi --skill imsg-loveoplay2023-hue

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill allows you to interact with your iMessage and SMS conversations directly from the command line, enabling you to list chats, view history, and send messages without opening the Messages.app.

Core Features & Use Cases

  • List Chats: View a list of your recent iMessage/SMS conversations.
  • View History: Retrieve message history for a specific chat, including attachments.
  • Send Messages: Compose and send text messages or messages with attachments to phone numbers or Apple IDs.
  • Watch for New Messages: Monitor a specific chat for incoming messages.
  • Use Case: You need to quickly send a text to a contact about a meeting update. This skill allows you to do so efficiently from your terminal.

Quick Start

Use the imsg skill to send a text message to +14155551212 with the content "Hello!".

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 command line on macOS?

You can send iMessage or SMS texts from the command line by using a CLI interface that communicates with macOS Messages.app, allowing you to dispatch messages to phone numbers or Apple IDs directly from your terminal.

Do I need Full Disk Access to manage iMessage conversations via a CLI?

Yes, managing iMessage conversations via a CLI requires Full Disk Access and Automation permissions enabled for Messages.app in your macOS settings to allow the terminal to read and send messages.

Can I retrieve message history and attachments from macOS Messages.app using the terminal?

Yes, you can retrieve message history and attachments from macOS Messages.app using the terminal by executing CLI commands designed to fetch and display your past conversation records and their associated files.

What is the best way to monitor incoming SMS messages without keeping the Messages.app open?

The best way to monitor incoming SMS messages without keeping the app open is using a CLI tool that continuously watches your specified chats in the background and retrieves new incoming texts as they arrive.

Does sending texts through macOS terminal CLI work with both iMessage and SMS?

Yes, sending texts through macOS terminal CLI works with both iMessage and SMS, utilizing the Messages.app backend to route and deliver your messages to either phone numbers or Apple IDs.

Why is my terminal unable to list chats or send messages through Messages.app?

Your terminal is unable to list chats or send messages through Messages.app likely because it lacks the required macOS permissions, specifically Full Disk Access and Automation privileges enabled for the Messages application.