imsg

Manage iMessage and SMS conversations on macOS via the Messages.app database.

Updated Mar 26, 2026
One-click install
npx skills add https://github.com/tedtv1007-ctrl/milk-skills-library --skill imsg-tedtv1007-ctrl
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imsg
Source: https://github.com/tedtv1007-ctrl/milk-skills-library/tree/main/imsg
Command: npx skills add https://github.com/tedtv1007-ctrl/milk-skills-library --skill imsg-tedtv1007-ctrl

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires imsg.

What problem does it solve?

This skill bridges the gap between your terminal and macOS Messages.app, allowing you to automate messaging tasks and retrieve conversation history without leaving your command line environment.

Core Features & Use Cases

  • Message Automation: Send text messages or attachments directly to contacts or phone numbers.
  • History Retrieval: Query and export chat history, including attachments, for analysis or archival.
  • Real-time Monitoring: Watch for incoming messages to trigger automated workflows or notifications.
  • Use Case: Quickly send a status update to a contact or search through recent chat logs to find specific information without opening the Messages application.

Quick Start

Use the imsg skill to send a text message to the phone number 14155551212 saying that you will be arriving late.

Frequently Asked Questions about imsg

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

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

You can send iMessage and SMS from the command line by using the imsg CLI tool to programmatically interface with the macOS Messages.app database, sending text or media content directly to specific recipients.

Can I retrieve iMessage chat history without opening the Messages app?

Yes, you can retrieve iMessage chat history without opening Messages by querying the chat database via the imsg CLI tool to list chats, export history, and access attachments for analysis or archival.

Do I need full disk access to automate messaging tasks on macOS?

Yes, you need full disk access and automation permissions granted on your macOS system to allow the imsg CLI tool to interface with the Messages.app database for managing conversations programmatically.

What is the best way to monitor incoming SMS messages for automated workflows?

The best way to monitor incoming SMS messages for automated workflows is using the imsg CLI tool to watch for new messages on macOS, triggering notifications or downstream automation without opening the GUI application.

Why does my CLI tool fail to access iMessage chat logs on macOS?

Your CLI tool fails to access iMessage chat logs when macOS system permissions for full disk access and automation are not properly configured, preventing the interface from reading the Messages.app database.