imsg

What This Skill Does

The imsg skill is a powerful command-line interface wrapper for macOS Messages.app, designed to integrate your messaging workflows directly into the OpenClaw AI agent environment. It enables the agent to interact with your iMessage and SMS threads, allowing for the retrieval of message history, monitoring of incoming communications, and the sending of new messages. By leveraging the local system infrastructure of macOS, this skill bridges the gap between your AI assistant and your native communication platform, ensuring you can manage personal or professional correspondence without leaving your terminal or chat interface.

Installation

To integrate this tool into your environment, use the OpenClaw installer provided in the source repository. Ensure that your terminal has 'Full Disk Access' granted within System Settings, as this is required to read the local Messages.app database. Additionally, verify that the application has the necessary automation permissions to trigger sends: clawhub install openclaw/openclaw/skills/imsg

Use Cases

This skill is perfect for automating routine communication. Whether you are checking for a quick update from a family member, searching through long-running conversation threads for specific details, or sending quick outbound texts, imsg provides a seamless bridge. It is particularly effective for users who prefer working in a command-line environment and want to centralize their interactions. Use it to scan for specific keywords in old chats, manage attachments, or trigger notifications when a high-priority conversation receives a new response.

Example Prompts

1. "Check my recent messages from 'Work Group' to see if there is an update on the meeting time."
2. "Send a text to Mom saying I'll be home in about 30 minutes."
3. "List the last 5 messages from the contact with ID 104 and show me any attached photos."

Tips & Limitations

• Safety First: Always use the --json flag to inspect outputs before performing operations. The agent is configured to ask for confirmation before sending, but you should verify recipients carefully.
• Scope: This skill is strictly for Apple Messages.app. It cannot manage third-party applications like WhatsApp, Slack, or Telegram, which have their own dedicated integrations.
• Performance: For large conversation histories, use the --limit flag to prevent memory bloat during parsing.
• Service Selection: If a message fails to send, ensure the recipient has iMessage enabled; otherwise, explicitly set the --service sms flag.