imessage

Send and receive iMessage and SMS messages via the imsg CLI on macOS.

247|22|Updated Dec 11, 2024
One-click install
npx skills add https://github.com/graniet/kheish --skill imessage-graniet
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/graniet/kheish/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/graniet/kheish --skill imessage-graniet

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually managing iMessage and SMS conversations through the macOS Messages app is time-consuming for repetitive or automated tasks, and this Skill removes that bottleneck by enabling programmatic message control via the imsg CLI.

Core Features & Use Cases

  • Send and receive messages: Dispatch iMessages or SMS to phone numbers or Apple IDs, and retrieve incoming message history for personal or automated use.
  • Access chat history: View recent conversations, including attachment details, by chat ID to quickly reference past interactions.
  • Monitor incoming messages: Watch for new messages in specific chats in real time to power automated response or notification workflows.
  • Real-world use case: Quickly send a pre-written text to a contact without opening the Messages app, or pull recent chat history with a vendor to reference past agreement details.

Quick Start

Use the imessage skill to send a text message saying "I'll be 10 minutes late" to your contact named "Mom".

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessage or SMS programmatically on macOS?

To send iMessage or SMS programmatically on macOS, you can use this Skill to dispatch messages to phone numbers or Apple IDs via the imsg CLI tool. It requires a macOS device with Messages.app configured and the imsg CLI installed via Homebrew.

Can I retrieve iMessage chat history and attachments from the command line?

Yes, you can retrieve iMessage chat history and attachment details from the command line. This Skill uses the imsg CLI to list active conversations and view recent message history by chat ID for quick reference.

Does sending iMessages via CLI require special macOS privacy permissions?

Sending iMessages via CLI requires appropriate macOS system privacy permissions. You must grant terminal and Messages.app access in your system settings for the imsg CLI tool to function correctly.

How do I monitor incoming iMessages for automated workflows?

You can monitor incoming iMessages for automated workflows by using this Skill to watch for new messages in specific chats in real time. This enables automated response or notification workflows without manually opening the Messages app.

What are the limitations of using a CLI tool for text messaging on macOS?

The primary limitation of using a CLI tool for text messaging on macOS is the strict dependency on the macOS ecosystem. It requires a configured Messages.app, Homebrew installation of imsg, and explicit system privacy permissions to operate.

Can I send file attachments through iMessage using the command line?

Yes, you can send file attachments through iMessage using the command line. This Skill supports sending text and file attachments directly to contacts via the imsg CLI tool on your macOS system.