imessage

Read, compose, and send iMessages or SMS via the macOS Messages app.

Updated Mar 7, 2026
One-click install
npx skills add https://github.com/Simon-Copilot-Studio/ai-content-hub --skill imessage-simon-copilot-studio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Simon-Copilot-Studio/ai-content-hub/tree/main/apple/imessage
Command: npx skills add https://github.com/Simon-Copilot-Studio/ai-content-hub --skill imessage-simon-copilot-studio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS Messages.app can be controlled via the imsg CLI to read and send iMessages/SMS, enabling automation and remote messaging workflows without manual UI interaction.

Core Features & Use Cases

  • List Chats: Retrieve recent chats with optional limits.
  • View History: Read conversation history and attachments.
  • Send Messages: Send text messages and attachments to phone numbers or Apple IDs.
  • Watch for New Messages: Listen for incoming messages in real time.
  • Service Options: Force iMessage or SMS when required, or let Messages.app decide automatically.
  • Rules & Safety: Always confirm recipients and content, verify paths, and avoid unknown numbers.

Quick Start

Ask to send a message to a contact by locating the chat and confirming the message before sending.

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 a terminal or automation script?

You can send iMessages from a terminal by using the imsg CLI to control macOS Messages.app, composing and sending texts to phone numbers or Apple IDs without manual UI interaction. The skill confirms recipients and content before sending.

Can I read iMessage chat history and attachments via command line?

Yes, you can read iMessage chat history and attachments via command line. The imsg CLI retrieves recent chats and views conversation history from the macOS Messages app for automation workflows.

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

Yes, macOS Messages.app access is required to automate iMessage sending. The skill enforces prerequisites including macOS Messages.app access and the imsg tool to read, compose, and send messages from a terminal.

What's the best way to monitor for new iMessages in real time?

The best way to monitor for new iMessages is using the imsg CLI watch feature, which listens for incoming messages in real time within your macOS Messages app automation context.

Can I force SMS instead of iMessage when sending messages from the command line?

Yes, you can force SMS instead of iMessage when sending messages from the command line. The imsg tool provides service options to force iMessage or SMS, or let Messages.app decide automatically.

How do I avoid unintended spam when automating SMS or iMessage workflows?

To avoid unintended spam when automating SMS or iMessage workflows, the skill includes guardrails to confirm recipients and content, verify attachment file paths, and prevent sending messages to unknown numbers.