imessage

Send and receive iMessages/SMS via the imsg command-line interface on macOS.

Updated May 15, 2026
One-click install
npx skills add https://github.com/cabezno/bmb-encover-agent --skill imessage-cabezno
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: imessage
Source: https://github.com/cabezno/bmb-encover-agent/tree/main/skills/apple/imessage
Command: npx skills add https://github.com/cabezno/bmb-encover-agent --skill imessage-cabezno

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It removes the manual effort of messaging from your Mac by letting you send iMessages/SMS and review recent conversations using a command-line workflow.

Core Features & Use Cases

  • Send iMessage/SMS: Deliver text (and optional attachments) to phone numbers or Apple IDs with explicit service selection.
  • Read and search conversations: List chats and fetch message history for a specific chat.
  • Monitor incoming messages: Watch a chat for new messages and optionally include attachment details.

Quick Start

Tell your agent to list your recent iMessage chats and return the results in JSON so you can pick the right conversation to message.

Frequently Asked Questions about imessage

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

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

You can send iMessages from the macOS command line by using the imsg tool to deliver text and optional attachments to phone numbers or Apple IDs with explicit service selection.

Can I retrieve iMessage chat history using a command line interface?

Yes, you can retrieve iMessage chat history by listing recent chats and fetching message history for a specific conversation, with options for JSON output and attachment details.

Do I need the Messages app signed in to automate SMS sending on macOS?

Yes, automating SMS and iMessage sending requires the macOS Messages.app to be signed in with appropriate terminal and automation permissions to function correctly.

How do I monitor incoming iMessages for new messages on macOS?

You can monitor incoming iMessages by watching a specific chat for new messages, which allows you to track ongoing conversations and include attachment details in the output.

What is the best way to search SMS conversations on macOS without opening the app?

The best way to search SMS conversations without opening the app is using the imsg command-line interface to list chats and fetch message history in JSON format.

Are there limitations when sending attachments via iMessage automation?

Attachment handling is supported but requires explicit service selection and proper macOS terminal permissions to ensure files are delivered correctly to the recipient.