imessage

Send and receive iMessage and SMS on macOS via imsg and osascript.

Updated Aug 23, 2026

Search Tags:#messaging #cli #macos #sms #contacts #imessage

Ready to run

npx skills add https://github.com/heg-wtf/cclaw --skill imessage-heg-wtf

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/heg-wtf/cclaw/tree/main/src/cclaw/builtin_skills/imessage
Command: npx skills add https://github.com/heg-wtf/cclaw --skill imessage-heg-wtf

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg, osascript, and includes references (resource) components.

What problem does it solve?

This Skill allows you to send and receive iMessages and SMS directly from your macOS device, integrating your messaging into your AI assistant's workflow.

Core Features & Use Cases

Send Messages: Compose and send iMessages or SMS to contacts.
Read Messages: View recent conversation history.
Contact Lookup: Find contact phone numbers by name.
Use Case: You can ask the AI to send a quick iMessage to a colleague confirming a meeting time, or to retrieve the last few messages from a specific chat.

Quick Start

Ask the imessage skill to send a text to John Doe saying "I'll be there in 5 minutes".

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?▼

To send iMessages on macOS, this skill uses the `imsg` CLI to compose and dispatch messages directly to your contacts. It automates the command execution for sending texts through your AI assistant.

Can I retrieve SMS conversation history using osascript and imsg?▼

Yes, retrieving SMS conversation history is supported via the `imsg` CLI. The skill executes `imsg` commands to fetch and view recent messages and chat history directly within your AI assistant's context.

Does the imessage skill require specific dependencies to work on macOS?▼

Yes, this skill requires the `imsg` CLI and `osascript` installed on your macOS system. These dependencies are essential for executing commands to send messages, retrieve history, and look up contacts.

How do I look up contact phone numbers for SMS without opening the Contacts app?▼

You can look up contact phone numbers using `osascript` instead of opening the Contacts app. The skill leverages `osascript` to resolve contact names to phone numbers directly within the AI's operational context.

What are the limitations of using imsg for sending SMS on macOS?▼

Using `imsg` for SMS on macOS is limited to environments where the `imsg` CLI and `osascript` are installed. As a CLI wrapper, it cannot bypass system-level messaging restrictions or send messages without valid local contact resolution.