imessage

Send and retrieve iMessage and SMS data through macOS Messages.app.

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

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 check recent chats directly from the command line.
  • Communication Automation: Send text messages or iMessages to specific contacts or phone numbers with support for file attachments.
  • Use Case: If you need to quickly notify a contact about a schedule change, you can instruct the agent to send a text message to that person without opening the Messages app.

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

Sending iMessages via the command line requires the imsg CLI tool, which bridges your terminal or AI agent to the macOS Messages.app for automated text messaging without opening the application.

Can I retrieve conversation history and read SMS data via terminal automation?

Yes, you can retrieve conversation history and read SMS data directly via terminal automation. The imsg CLI tool queries the macOS Messages.app interface to look up past conversations and recent chats.

Do I need special macOS system permissions to automate text messaging?

Yes, automating text messaging via the imsg CLI requires full disk access and automation permissions in macOS. These system privileges allow the tool to interact with the Messages.app interface.

Does command line iMessage automation support sending file attachments?

Yes, command line iMessage automation supports sending file attachments. The imsg CLI tool handles attachment transmission alongside text messages to specific contacts or phone numbers.

What are the limitations of using the imsg CLI for communication automation?

The imsg CLI is limited to macOS environments and requires the Messages.app interface. It depends on full disk access and automation permissions, meaning it cannot operate on non-Apple platforms.

What is the best way to notify a contact about a schedule change without opening Messages?

The best way to notify a contact without opening Messages is using the imsg CLI tool to send an automated text message to their phone number directly from your terminal or AI agent interface.