imessage

Read, compose, and manage iMessages via the imsg CLI on macOS.

31|3|Updated May 7, 2026
One-click install
npx skills add https://github.com/markwang2658/hermes-windows-native --skill imessage-markwang2658
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/markwang2658/hermes-windows-native/tree/main/hermes-agent/skills/apple/imessage
Command: npx skills add https://github.com/markwang2658/hermes-windows-native --skill imessage-markwang2658

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read, compose, and manage iMessages and SMS directly from macOS using the imsg CLI, streamlining messaging automation and integration with scripts.

Core Features & Use Cases

  • Read chat history and list conversations from Messages.app using imsg
  • Send texts or iMessages to phone numbers or Apple IDs
  • Automate simple messaging workflows and integrate with existing tools

Quick Start

Install imsg on macOS, ensure Messages.app is signed in, and run a sample command to send or view messages.

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 via the command line on macOS using the imsg CLI. It allows you to compose and send texts directly to phone numbers or Apple IDs, streamlining messaging automation and script integration.

Can I retrieve iMessage chat history using a CLI tool?

Yes, you can retrieve iMessage chat history using the imsg CLI. It reads chat history and lists conversations directly from the Messages.app on macOS for personal messaging tasks.

What do I need to automate SMS and iMessage workflows on macOS?

To automate SMS and iMessage workflows on macOS, you need macOS with Messages.app signed in and the imsg CLI tool installed. This setup allows you to integrate messaging with existing scripts.

Does the imsg CLI work with both phone numbers and Apple IDs?

Yes, the imsg CLI works with both phone numbers and Apple IDs. You can use it to send texts or iMessages to either identifier as long as Messages.app is signed in on your macOS device.

What is the best way to integrate iMessage automation with existing scripts?

The best way to integrate iMessage automation with existing scripts is using the imsg CLI on macOS. It enables you to programmatically read, compose, and manage iMessages and SMS without manual GUI interaction.