imsg
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
Why use this skill?
Seamlessly read and send iMessage and SMS messages through macOS Messages.app using the OpenClaw imsg skill. Automate your chats easily.
Install via CLI (Recommended)
clawhub install openclaw/openclaw/skills/imsgWhat 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
- "Check my recent messages from 'Work Group' to see if there is an update on the meeting time."
- "Send a text to Mom saying I'll be home in about 30 minutes."
- "List the last 5 messages from the contact with ID 104 and show me any attached photos."
Tips & Limitations
- Safety First: Always use the
--jsonflag 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
--limitflag 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 smsflag.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-openclaw-imsg": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: file-read, file-write
Related Skills
sag
ElevenLabs text-to-speech with mac-style say UX.
bear-notes
Create, search, and manage Bear notes via grizzly CLI.
mcporter
Use the mcporter CLI to list, configure, auth, and call MCP servers/tools directly (HTTP or stdio), including ad-hoc servers, config edits, and CLI/type generation.
eightctl
Control Eight Sleep pods (status, temperature, alarms, schedules).
xurl
A CLI tool for making authenticated requests to the X (Twitter) API. Use this skill when you need to post tweets, reply, quote, search, read posts, manage followers, send DMs, upload media, or interact with any X API v2 endpoint.