imessage

Send and read iMessages and SMS on macOS via the imsg CLI.

Updated May 3, 2026
One-click install
npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill imessage-yangel-hide
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Yangel-hide/video-production-planner-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Yangel-hide/video-production-planner-agent --skill imessage-yangel-hide

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables reading and sending iMessages/SMS from macOS using the imsg CLI, automating conversational tasks and messaging workflows.

Core Features & Use Cases

  • Read recent chats and conversation history from Messages.app
  • Send messages to phone numbers or Apple IDs with optional attachments (if supported by imsg)
  • Watch for new messages and respond or trigger workflows automatically
  • Use case: automate sending a reminder to a contact, or fetch history to summarize a conversation for context

Quick Start

Use imsg to read chats or send a message to a contact, for example imsg send --to "+15551234567" --text "I'll be there".

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 texts from a macOS command line?

You can automate sending iMessage texts on macOS by using the imsg CLI. This Skill uses imsg to send messages to phone numbers or Apple IDs directly from the command line, automating your conversational tasks and messaging workflows.

Can I read conversation history from Messages.app using a CLI tool?

Yes, you can read conversation history from Messages.app using a CLI tool. This Skill applies the imsg CLI to read recent chats and audit conversation history on macOS, allowing you to fetch context for specific contacts.

Do I need specific macOS permissions to automate iMessage workflows via CLI?

Yes, automating iMessage workflows via CLI requires specific macOS permissions. You need macOS with Messages.app installed, the imsg CLI tool, and must grant Full Disk Access and Automation permissions for the operations to function correctly.

What is the best way to watch for new SMS messages and trigger automated workflows on macOS?

The best way to watch for new SMS messages on macOS is using an automation CLI. This Skill enables watching for new messages via the imsg CLI, allowing you to automatically respond or trigger downstream messaging workflows when new texts arrive.

How to send iMessage attachments to a contact using automation?

To send iMessage attachments using automation, you can use the imsg CLI. This Skill supports sending messages to contacts with optional attachments if the feature is supported by your imsg installation, streamlining content delivery workflows.