imsg

Access iMessage and SMS chats from the macOS command line.

Updated May 18, 2022
One-click install
npx skills add https://github.com/kendreaditya/.config --skill imsg-kendreaditya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/kendreaditya/.config/tree/main/claude/skills/imsg
Command: npx skills add https://github.com/kendreaditya/.config --skill imsg-kendreaditya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

iMessage/SMS automation on macOS enables listing chats, viewing history, and sending messages from the terminal, reducing friction when interacting with Messages.app.

Core Features & Use Cases

  • List chats and view recent history from Messages.app.
  • Send messages to phone numbers or Apple IDs.
  • View chat metadata and perform scripted workflows from the command line.

Quick Start

Install imsg and start by listing chats with imsg chats to preview conversations.

Frequently Asked Questions about imsg

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?

You can send iMessages from the command line by using this tool to target phone numbers or Apple IDs directly from the terminal. It requires granting Full Disk Access and automation permissions to Messages.app for successful delivery.

Can I list and view my iMessage chat history in the terminal?

Yes, you can list chats and view recent history from Messages.app directly in the terminal. This command-line approach retrieves chat metadata and conversation logs, reducing friction when interacting with your messages.

What macOS permissions are required to read iMessage conversations?

Reading iMessage conversations requires Full Disk Access and automation permissions on macOS. These security clearances are necessary for the command-line tool to access Messages.app data, view chat history, and send messages.

Does this command-line iMessage tool support sending attachments?

The tool includes user-safety checks for recipient confirmation and attachments. It is designed to handle scripted workflows from the command line, covering macOS compatibility and both reading and sending capabilities.

What is the best way to automate SMS workflows on macOS?

Automating SMS workflows on macOS is best done through command-line access to Messages.app. This method enables listing chats, viewing history, and sending messages from the terminal, streamlining scripted interactions without manual app navigation.