imessage

Send and retrieve iMessage and SMS messages via the imsg CLI.

1|Updated Apr 10, 2026
One-click install
npx skills add https://github.com/lava-chen/duya --skill imessage-lava-chen
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/lava-chen/duya/tree/main/packages/agent/skills/apple/imessage
Command: npx skills add https://github.com/lava-chen/duya --skill imessage-lava-chen

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of accessing and controlling macOS Messages conversations by providing a simple way to send and retrieve iMessage and SMS messages through the imsg CLI.

Core Features & Use Cases

  • Message Management: Read chat histories, list conversations, and monitor incoming messages from Messages.app.
  • Message Sending: Send iMessages or SMS messages to phone numbers and Apple IDs with optional attachments.
  • Use Case: Ask the Skill to send a text update to a contact, review recent conversations, or check message history from a Mac workspace.

Quick Start

Use the imessage skill to send a message saying "I will be late" to my saved contact after confirming the recipient.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I automate sending iMessage and SMS texts from macOS?

This Skill retrieves chat histories and monitors incoming messages by accessing the macOS Messages application through the imsg command-line tool, allowing you to read past conversations directly from your Mac workspace.

What do I need to retrieve iMessage chat history on a Mac?

To retrieve iMessage chat history on a Mac, you need the imsg command-line tool installed and macOS Messages permissions granted so the Skill can access and list your conversations.

Can I send attachments with iMessage through macOS automation?

Yes, you can send attachments with iMessage through macOS automation, as the Skill supports sending messages with optional attachments to phone numbers and Apple IDs via the Messages application.

Does this iMessage automation tool work without a Mac environment?

No, this iMessage automation tool does not work without a Mac environment, because it directly interfaces with the macOS Messages application and requires the imsg command-line tool to access conversations.

Why are my outbound iMessages failing to send through the Messages app?

Outbound iMessages may fail if macOS Messages permissions are not approved or the imsg command-line tool is missing, since the Skill relies on these components to deliver texts to contacts.