imsg

Read and send iMessage/SMS via macOS Messages.app from a CLI.

4|1|Updated Mar 6, 2026
One-click install
npx skills add https://github.com/adamhjouj/shieldclaw --skill imsg-adamhjouj
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/adamhjouj/shieldclaw/tree/main/openclaw/skills/imsg
Command: npx skills add https://github.com/adamhjouj/shieldclaw --skill imsg-adamhjouj

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Read and send iMessage/SMS via macOS Messages.app from the terminal, enabling automation and scripting of common messaging tasks.

Core Features & Use Cases

  • Read chats and history and send messages programmatically from the terminal.
  • Works with Apple IDs and phone numbers via Messages.app on macOS, enabling automation of routine messaging workflows.

Quick Start

Use imsg to read and send iMessages from macOS Messages.app.

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessage from the command line on macOS?

To send iMessages via CLI, this Skill automates macOS Messages.app, requiring Full Disk Access for your terminal and Automation permission for Messages.app to send texts to phone numbers or Apple IDs.

Can I read iMessage chat history from a terminal script?

Reading iMessage chat history via CLI is supported by this Skill, which programmatically accesses chats and history through macOS Messages.app to enable routine messaging automation workflows.

What macOS permissions do I need to automate Messages.app?

To automate Messages.app, you need macOS with Messages.app signed in, Full Disk Access for your terminal, and Automation permission for Messages.app to allow programmatic reading and sending of SMS.

Is there a CLI tool to script SMS sending on macOS?

Yes, this Skill provides a CLI tool to script SMS sending on macOS by automating Messages.app, allowing you to programmatically send messages to phone numbers or Apple IDs directly from your terminal.

Why is my iMessage CLI automation not working on macOS?

Your iMessage CLI automation might fail if macOS Messages.app is not signed in, or if your terminal lacks Full Disk Access and Automation permission for Messages.app, which are required for programmatic access to chats.