imessage

Send and retrieve iMessages on macOS using the imsg CLI.

78|16|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill imessage-sheawinkler
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/sheawinkler/hermes-agent-ultra/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/sheawinkler/hermes-agent-ultra --skill imessage-sheawinkler

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enable programmatic sending and reading of iMessages and SMS on macOS from an automation layer, reducing manual interaction with Messages.app.

Core Features & Use Cases

  • Send messages from scripts with automated prompts
  • Read chat histories and list recent conversations
  • Monitor for new messages and trigger downstream workflows
  • Control contacts by phone number or Apple ID

Quick Start

Send a test message to a contact using the imsg CLI to verify setup.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send iMessages programmatically from an AI assistant on macOS?

You can send iMessages programmatically on macOS by using the imsg CLI within your AI automation workflows to trigger text sending and reduce manual interaction with Messages.app.

Can I read iMessage chat history and monitor conversations using CLI automation?

Reading iMessage chat history and monitoring conversations is supported via the imsg CLI, allowing you to retrieve past messages, list recent chats, and trigger downstream workflows when new messages arrive.

Do I need macOS and Messages.app access to automate SMS and iMessage sending?

Yes, automating SMS and iMessage sending requires macOS and active Messages.app access, along with the imsg CLI prerequisite installed to bridge the automation layer with Apple's messaging infrastructure.

How can I control contacts when sending automated iMessages from scripts?

When sending automated iMessages from scripts, you can control contacts by specifying either their phone number or Apple ID directly within the imsg CLI command arguments.

Are there authorization and safety checks for monitoring iMessage conversations?

Yes, the imsg CLI supports authorization and safety checks to prevent misuse when monitoring iMessage conversations, ensuring that programmatic access to messaging history remains secure.

What is the best way to integrate proactive messaging into macOS automation workflows?

The best way to integrate proactive messaging into macOS automation workflows is using the imsg CLI to programmatically send texts to contacts, enabling automated alerts and proactive communication without manual input.