imessage

Send and read iMessages and SMS via the imsg CLI on macOS.

2|Updated May 22, 2026
One-click install
npx skills add https://github.com/519lab/thoth-agent --skill imessage-519lab
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/519lab/thoth-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/519lab/thoth-agent --skill imessage-519lab

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, and includes scripts (resource) components.

What problem does it solve?

The manual process of using macOS Messages.app to send and receive iMessages/SMS can be time-consuming. This skill provides an automated command-line interface (CLI) to perform these actions efficiently.

Core Features & Use Cases

  • Command-Line Interaction: Access your iMessages/SMS directly via the terminal.
  • Message Automation: Send and read iMessages without leaving your CLI.
  • Use Case: Quickly respond to text messages or iMessages, or view your chat history using simple CLI commands.

Quick Start

Use imsg send --to "+14155551212" --text "Hello!" to send a message through iMessage.

Frequently Asked Questions about imessage

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

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

You can send iMessages from the macOS terminal by executing a command with the recipient's number and text. This CLI utility interacts with macOS Messages.app to automate message sending.

Can I read my iMessage chat history via the command line?

Yes, you can read your iMessage chat history via the command line. The utility interfaces with the native macOS Messages.app infrastructure to retrieve and view your messages.

Does this command-line iMessage tool work for SMS as well?

Yes, this command-line iMessage tool works for SMS as well. It utilizes the macOS Messages.app infrastructure to send and receive both iMessages and SMS text messages.

Do I need macOS to use the terminal iMessage CLI?

Yes, you need macOS to use the terminal iMessage CLI. The utility relies on the native Messages.app infrastructure, which is exclusively available on the macOS platform.

What is the best way to automate sending texts on a Mac without opening the Messages app?

The best way to automate sending texts on a Mac without opening the Messages app is using a CLI utility. It interacts directly with Messages.app infrastructure to send iMessages and SMS.