skills.rest
heg-wtf
heg-wtfOFFICIAL
Explore all skills by this author →
WebsiteGitHub

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
One-click install
npx skills add https://github.com/heg-wtf/cclaw --skill imessage-heg-wtf
Or copy as Structured Prompt for Agent▼
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.

Related Skills

Explore More Content & Communication Skills→
kaminocorpkaminocorp
228

imessage

Send and read iMessages on macOS via the imsg CLI.

Official
Intermediate
bbugyi200bbugyi200
5

sase_chats

Search and summarize local sase agent chat transcripts using the sase CLI.

Community
Intermediate
wuv-dreamguidewuv-dreamguide

imsg

Read and send iMessage and SMS messages from the macOS terminal.

Official
Intermediate
11547613341154761334

local-testing

Automate macOS native app UI testing with AppleScript and screenshots.

Community
Intermediate