imessage

Send and receive iMessages/SMS from the macOS terminal via imsg CLI.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill solves the issue of manually sending and receiving iMessages or SMS messages by providing a command-line interface to do so directly from your macOS terminal.

Core Features & Use Cases

  • Command-Line Messaging: Send and receive iMessages/SMS from the terminal.
  • Integration with macOS Messages.app: Works seamlessly with your existing Messages.app setup.
  • Use Case: Quickly send a message to a friend or check your iMessage history without opening the Messages.app.

Quick Start

Send an iMessage to +14155551212 with the text "Hello!" using the imsg send command.

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

To send iMessages from the command line, you can use a CLI tool that interfaces directly with macOS Messages.app. This allows you to execute messaging commands directly from your terminal without opening the graphical application.

Can I integrate SMS messaging into my macOS shell scripts?

Yes, you can integrate SMS messaging into macOS shell scripts by using a command-line interface for Messages.app. This enables automated sending and receiving of text messages within your custom terminal workflows.

Do I need any specific dependencies to send iMessages via the terminal?

Sending iMessages via the terminal requires the imsg CLI tool and appropriate permissions configured for macOS Messages.app. You must ensure your macOS environment grants the necessary accessibility access to control messaging.

What is the best way to check iMessage history without opening the Messages app?

The best way to check iMessage history without the app is using a command-line interface like imsg to query Messages.app. This lets you quickly read and retrieve message logs directly in your terminal window.

Does command-line iMessage integration work outside the macOS environment?

Command-line iMessage integration does not work outside the macOS environment because it relies exclusively on the native macOS Messages.app framework. It is strictly designed for users operating within the Apple ecosystem.

Why does my command-line iMessage script fail to send text?

Command-line iMessage scripts fail to send text when the imsg CLI lacks the required permissions for macOS Messages.app. You must authorize terminal automation within your macOS security settings to resolve the issue.