imessage

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your AI agent and your macOS Messages application, allowing you to manage personal and professional communications without leaving your terminal or agent interface.

Core Features & Use Cases

  • Message Management: Read conversation history and send new messages directly from the command line.
  • Contextual Awareness: Easily check recent chats or verify message threads before responding.
  • Use Case: When a user asks to notify a contact about a schedule change, the agent can quickly look up the correct chat thread and send the message via iMessage or SMS.

Quick Start

Use the imessage skill to send a text message to the contact associated 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 the command line on macOS?

You can send iMessages from the command line on macOS by using the imsg CLI tool to programmatically dispatch messages and SMS to contacts directly from your terminal or AI agent interface.

Can I retrieve iMessage chat history programmatically?

Yes, you can retrieve iMessage chat history programmatically. The imsg CLI tool allows you to look up conversation history and check recent chat threads for contextual awareness before responding.

What macOS permissions are required to automate iMessage sending?

To automate iMessage sending on macOS, you need to grant Full Disk Access and automation permissions to the imsg CLI tool so it can interact with the Messages application and read chat databases.

Does the imsg CLI tool support SMS as well as iMessage?

Yes, the imsg CLI tool supports SMS as well as iMessage. It facilitates the programmatic sending and retrieval of both iMessage and SMS communications on compatible macOS systems.

What is the best way to integrate macOS messaging into an AI agent workflow?

The best way to integrate macOS messaging into an AI agent workflow is using the imsg CLI tool, which bridges your agent and the Messages app to manage communications without leaving the terminal interface.