imessage

Send and retrieve iMessage and SMS messages via the macOS Messages application.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your desktop messaging environment and your AI agent, allowing you to manage personal and professional communications without leaving your terminal.

Core Features & Use Cases

  • Seamless Messaging: Send text messages and attachments directly to contacts via iMessage or SMS.
  • Conversation Management: Retrieve and monitor chat history to stay updated on ongoing discussions.
  • Use Case: When you are busy in a deep-work session, use this skill to quickly check if a specific contact has replied to your message or to send a brief update to a colleague without switching applications.

Quick Start

Use the imessage skill to send a text message to the contact with the phone number 14155551212 saying that you will be arriving late.

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 terminal script?

You can send iMessages from a terminal by using this skill to programmatically dispatch text or file-based content to specific contacts via the macOS Messages application. It requires the imsg command-line utility to bridge the terminal and the messaging app.

Can I retrieve and monitor iMessage chat history via command line?

Yes, you can retrieve and monitor iMessage chat history via command line. This skill allows you to query past conversations and monitor new incoming messages programmatically, helping you stay updated on ongoing discussions without opening the Messages app.

What macOS permissions are required to automate text messaging?

Automating text messaging on macOS requires Full Disk Access and Automation permissions. These system privileges are necessary for the imsg command-line utility to interact with the native Messages application database and dispatch communications.

Does the imsg utility support sending SMS attachments to contacts?

Yes, the imsg utility supports sending SMS attachments to contacts. The skill facilitates dispatching both text messages and file-based content directly to recipients via iMessage or SMS through the macOS Messages application.

Why is my iMessage automation not working on macOS?

iMessage automation may fail on macOS if the imsg command-line utility lacks Full Disk Access or Automation permissions. Ensure your system settings grant these privileges so the terminal can properly interface with the Messages application database.

What is the best way to check for new iMessages during deep work?

The best way to check for new iMessages without switching applications is to use this skill to monitor incoming messages. It queries the macOS Messages application directly, allowing you to see if specific contacts have replied while remaining in your terminal.