imessage

Send and retrieve iMessage and SMS data via the macOS Messages application.

9|Updated Jul 1, 2026
One-click install
npx skills add https://github.com/Cyapstaye/Adame_ver.open --skill imessage-cyapstaye
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/Cyapstaye/Adame_ver.open/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/Cyapstaye/Adame_ver.open --skill imessage-cyapstaye

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your desktop agent and your macOS Messages app, allowing you to manage personal and professional communications without leaving your workflow.

Core Features & Use Cases

  • Seamless Messaging: Send text messages or iMessages to contacts using their phone number or Apple ID.
  • Conversation Management: Read and monitor message history or check recent chats directly through the agent.
  • Use Case: If a user asks to notify a colleague about a delay, the agent can look up the correct chat thread and send the message instantly while maintaining context.

Quick Start

Use the imessage skill to send a text message to the contact associated with the phone number 555-0199 saying that you will be arriving late.

Frequently Asked Questions about imessage

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

FAQPage Schema
How do I send and receive iMessages from the terminal?

Use the imsg CLI tool to programmatically send and retrieve iMessage and SMS data via the macOS Messages application. This skill bridges your desktop agent and Messages app, allowing you to query chat history, monitor incoming messages, and dispatch text communications.

Can I automate SMS messaging on macOS?

Yes, you can automate SMS messaging on macOS through this skill. It facilitates the programmatic sending of text communications to specific recipients using their phone number or Apple ID, while also supporting conversation management and monitoring incoming messages.

What do I need to set up before automating iMessage dispatching?

You need to install and configure the imsg CLI tool with appropriate system permissions for disk access and automation. These permissions are required to allow programmatic interaction with the macOS Messages application for sending and retrieving messages.

Does the imessage skill work with standard SMS or only Apple IDs?

The skill works with both standard SMS and iMessage. It facilitates the programmatic sending and retrieval of both message types, allowing you to dispatch text communications to contacts using either a phone number or an Apple ID.

How do I query iMessage chat history through a desktop agent?

You can query iMessage chat history by using this skill to read and monitor message history or check recent chats directly through the agent. It retrieves iMessage and SMS data directly from the macOS Messages application via the imsg CLI tool.

Are there limitations when programmatically accessing macOS Messages?

A key limitation is the strict dependency on system permissions. The skill requires the imsg CLI tool to be configured with appropriate system permissions for disk access and automation to function correctly on macOS.