imsg

Control iMessage and SMS via a macOS CLI for Messages.app.

Updated Mar 11, 2026

Search Tags:#cli #macos #sms #imessage #imsg #messages-app

Ready to run

npx skills add https://github.com/x402agent/NanoSolana --skill imsg-x402agent

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/x402agent/NanoSolana/tree/main/skills/imsg
Command: npx skills add https://github.com/x402agent/NanoSolana --skill imsg-x402agent

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manage iMessage and SMS conversations directly from the terminal, eliminating the need to switch to the Messages.app for routine tasks.

Core Features & Use Cases

List chats and fetch recent history from Messages.app.
Send iMessage or SMS from the command line with optional service control.
Integrate messaging into scripts and automation on macOS to streamline workflows.

Quick Start

Install imsg and run imsg to list chats, view history, and send messages through Messages.app.

Frequently Asked Questions about imsg

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

FAQPage Schema

How do I send an iMessage or SMS from the macOS terminal?▼

To send an iMessage or SMS from the macOS terminal, use a command line interface that controls Messages.app. It enables sending messages with optional service control directly from your terminal session.

Can I list chats and fetch message history from Messages.app via command line?▼

Yes, you can list chats and fetch recent history from Messages.app via the command line. A CLI tool can read your chat history programmatically, eliminating the need to open the app for routine message viewing tasks.

What macOS permissions are required to control iMessage from a CLI?▼

To control iMessage from a CLI, your macOS terminal requires Full Disk Access to read chats. You also need Messages.app signed in, and Automation permission for Messages.app to send messages.

How do I automate routine messaging tasks on macOS without opening the Messages app?▼

You automate routine messaging tasks on macOS by integrating a CLI tool into your scripts to send messages and fetch history. This exposes Messages.app actions to larger terminal-based automation workflows, streamlining routine tasks.

Are there limitations when using a CLI to send SMS on macOS?▼

Limitations of using a CLI to send SMS on macOS include strict dependency on native macOS permissions. If the terminal lacks Full Disk Access or Messages.app lacks Automation permission, the CLI cannot read chats or send messages.