> imsg

iMessage/SMS CLI for listing chats, fetching history, watching conversations, and sending messages on macOS via the Messages app. Use when the user wants to send a text message, read iMessages, check recent texts, reply to a conversation, send an SMS, or interact with the Messages app from the terminal. Supports texting contacts by phone number or email, attaching files, and streaming incoming messages in real time.

fetch
$curl "https://skillshub.wtf/elizaOS/eliza/imsg?format=md"
SKILL.mdimsg

imsg Actions

Overview

Use imsg to read and send Messages.app iMessage/SMS on macOS.

Requirements: Messages.app signed in, Full Disk Access for your terminal, and Automation permission to control Messages.app for sending.

Inputs to collect

  • Recipient handle (phone/email) for send
  • chatId for history/watch (from imsg chats --limit 10 --json)
  • text and optional file path for sends

Actions

List chats

imsg chats --limit 10 --json

Fetch chat history

imsg history --chat-id 1 --limit 20 --attachments --json

Watch a chat

imsg watch --chat-id 1 --attachments

Send a message

imsg send --to "+14155551212" --text "hi" --file /path/pic.jpg

Notes

  • --service imessage|sms|auto controls delivery.
  • Confirm recipient + message before sending.

Ideas to try

  • Use imsg chats --limit 10 --json to discover chat ids.
  • Watch a high-signal chat to stream incoming messages.

┌ stats

installs/wk0
░░░░░░░░░░
github stars17.8K
██████████
first seenMar 17, 2026
└────────────

┌ repo

elizaOS/eliza
by elizaOS
└────────────

┌ tags

└────────────