# 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. Use when this capability is needed. - Skill: `tomevault-io/imsg` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/imsg` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/imsg/raw - Safety review: pending (external: skill-scanner PASS, skillspector PASS) - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Productivity - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/imsg --- # 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 ```bash imsg chats --limit 10 --json ``` ### Fetch chat history ```bash imsg history --chat-id 1 --limit 20 --attachments --json ``` ### Watch a chat ```bash imsg watch --chat-id 1 --attachments ``` ### Send a message ```bash 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. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/elizaos) — claim your Tome and manage your conversions.