skills.rest
0xKobold
0xKoboldOFFICIAL
Explore all skills by this author →
GitHub

imsg

List chats, view history, and send iMessage and SMS via macOS Messages.app.

4|2|Updated Mar 16, 2026
Search Tags:#automation#macos#messages#sms#imessage#imsg
One-click install
npx skills add https://github.com/0xKobold/0xkobolds --skill imsg-0xkobold
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/0xKobold/0xkobolds/tree/main/skills/imsg
Command: npx skills add https://github.com/0xKobold/0xkobolds --skill imsg-0xkobold

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Use iMessage and SMS via macOS Messages.app to read chats, view history, and send messages programmatically, enabling automation-friendly communications.

Core Features & Use Cases

  • List chats with metadata and limits
  • View chat history and attachments
  • Send messages to phone numbers or Apple IDs
  • Watch for new messages and trigger workflows

Quick Start

Install the tool on macOS, ensure Messages.app is signed in, and run imsg chats --limit 10 --json to list chats

Frequently Asked Questions about imsg

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

FAQPage Schema
How do I send iMessage or SMS programmatically on macOS?▼

You can send iMessage or SMS programmatically on macOS by running the 'imsg send' command to dispatch messages directly to phone numbers or Apple IDs through the native Messages.app.

Can I list and read iMessage chat history from the command line?▼

Yes, you can list active conversations with 'imsg chats' and retrieve specific conversation history using 'imsg history', returning chat metadata and attachments directly in your terminal.

Do I need automation permissions to use iMessage scripts on macOS?▼

Yes, you need macOS automation permissions granted to your terminal or script environment, and the Messages.app must be actively signed in to your Apple ID for the tool to read and send messages.

What is the best way to watch for new iMessage messages and trigger a workflow?▼

The best way to watch for new iMessage messages is to use the 'imsg' watch command, which monitors Messages.app activity and triggers downstream automation workflows when fresh SMS or iMessage data arrives.

Does this iMessage automation tool support exporting chat history as JSON?▼

Yes, the tool supports JSON output for chat data. You can run commands like 'imsg chats --limit 10 --json' to format your conversation lists and metadata as structured JSON for automated processing.

Related Skills

Explore More Content & Communication Skills→
anxiety135790anxiety135790

imessage

Send iMessage and SMS messages via the macOS Messages.app command-line interface.

Community
Intermediate
ShenSeanChenShenSeanChen
16

WhatsApp Chat Parser

Parse WhatsApp chat exports into structured JSON data.

Community
Basic
aayushsoamaayushsoam
1

imsg

Automate iMessage/SMS sending and chat history retrieval via macOS Messages.app.

Community
Intermediate
Zentin-LZentin-L
1

imsg

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

Community
Intermediate