Skip to content
Get packs

iMessage and SMS via imsg

Lets your agent list, read, watch and send iMessage/SMS messages on a Mac via Messages.app

Source Download skill
Repository
spinabot/brigade
Stars
11,367
Licence
MIT
Files
1 file

What it does

This skill teaches an AI agent to use a command-line tool called imsg to work with the Messages app on a Mac. Once installed, the agent can list recent chats, read conversation history, watch for new messages, and send texts or attachments to phone numbers or Apple IDs. The skill also tells the agent to confirm the recipient and message wording before sending, and to avoid mass messaging or messaging on other platforms.

Great for

  • Mac users who want an assistant to read or send iMessages and texts on their behalf
  • People who already have the imsg tool installed via Homebrew and signed in to Messages.app
  • Users who want the agent to check recent chats before drafting a reply

Skip it if

  • Windows or Linux machines, since the skill is limited to macOS (darwin) and needs Messages.app (risk: it will simply not work)
  • Sending messages on WhatsApp, Telegram, Slack or Discord, which the skill explicitly routes to other tools (risk: wrong channel used)
  • Bulk or automated mass texting, which the skill says must be confirmed with the user first (risk: spam or account restrictions)

Try asking

  • “Text mom that I'll be late, but show me the recipient first”
  • “Show me my last 10 Messages chats”
  • “Read the last 20 messages in my chat with Alex, including attachments”
  • “Send this photo to +14155551212 with the caption 'Check this out'”
Step-by-step guide: how to use iMessage and SMS via imsgInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the MIT licence and an attribution note.

    imsg.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip imsg.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip imsg.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Ask the agent to list chats first so it can pick the correct chat ID or phone number rather than guessing
  • Review the drafted recipient and text before approving, since the skill asks for confirmation but sent iMessages cannot be recalled
  • Use --service imessage or --service sms only when you know which delivery type you need; the default auto setting lets Messages.app decide

What's inside

  • SKILL.md

Redistributed unmodified from spinabot/brigade under the MIT licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.