skills.rest
kwasi-cpu
kwasi-cpuCOMMUNITY
Explore all skills by this author →
GitHub

imessage

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

Updated Aug 27, 2026
Search Tags:#messaging#communication#macos#apple#sms#imessage
One-click install
npx skills add https://github.com/kwasi-cpu/hermes-agent --skill imessage-kwasi-cpu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/kwasi-cpu/hermes-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/kwasi-cpu/hermes-agent --skill imessage-kwasi-cpu

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill allows you to send and receive iMessages and SMS directly from your macOS device, bridging the gap between your AI agent and your personal communications.

Core Features & Use Cases

  • Send Messages: Compose and send text messages or messages with attachments to phone numbers or Apple IDs.
  • View History: Retrieve past conversation logs, including message content and attachment information.
  • List Chats: Get a list of your recent iMessage/SMS conversations.
  • Use Case: When a user asks to send a quick text to a contact, this skill can handle the request by interacting with the macOS Messages application.

Quick Start

Send the message "I'll be late" to your mom using the imessage skill.

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 a macOS terminal?▼

To send iMessages from a macOS terminal, you can use this Skill to bridge your AI agent with the Messages.app via the `imsg` CLI tool. It enables sending text messages and attachments directly to phone numbers or Apple IDs.

Do I need macOS to send and receive SMS with this approach?▼

Yes, you need macOS to send and receive SMS and iMessages using this approach. It requires the Messages.app to be signed in, alongside the installation of the `imsg` CLI tool with appropriate permissions.

Can I retrieve past iMessage conversation logs on macOS?▼

Yes, you can retrieve past iMessage conversation logs on macOS using this Skill. It allows you to view message history, including message content and attachment information, by interacting with the Messages.app database.

How do I list recent iMessage and SMS chats programmatically?▼

You can list recent iMessage and SMS chats programmatically by using this Skill to query the Messages.app. It retrieves a list of your recent conversations, allowing your AI agent to review and manage personal messaging tasks.

What are the limitations of using the imsg CLI for messaging?▼

A key limitation of using the `imsg` CLI for messaging is its strict dependency on macOS and an actively signed-in Messages.app. It is strictly for personal messaging tasks and cannot function without the required permissions.

Does this method work with attachments for SMS on Apple devices?▼

Yes, this method works with attachments for SMS on Apple devices. The Skill allows you to compose and send messages with attachments to phone numbers or Apple IDs, and also retrieves attachment information from past conversations.

Related Skills

Explore More Content & Communication Skills→
steipetesteipete
385.7k

imsg

Read and send iMessage/SMS conversations on macOS via a CLI tool.

Community
Intermediate
SethyPagnaSethyPagna

imessage

Send and receive iMessages and SMS through macOS Messages.app.

Community
Intermediate
Brilly-BohyunBrilly-Bohyun

imessage

Send and receive iMessages/SMS with attachments from the macOS terminal.

Community
Basic
afel6afel6

imessage

Send and receive iMessage and SMS messages via macOS Messages.app.

Community
Intermediate