imsg
iMessage/SMS CLI for listing chats, history, and sending messages via Messages.app.
pinned to #7211328updated 2 weeks ago
Ask your AI client: “install skills/imsg”.
Requires the metahub MCP server installed in your client. Set up MCP.
mh install skills/imsgmetahub onboarded this repo on the author's behalf.
If you own github.com/the-open-agent/openagent on GitHub, claim the listing to take over publishing. Your claim preserves the existing eval history and badges; only the curator label is replaced with verified-publisher on your next publish.
Stars
5,378
Last commit
2 weeks ago
Latest release
published
- #agent
- #agentic
- #agentic-ai
- #agi
- #chatbot
- #chatgpt
- #gpt
- #harness
- #hermes-agent
- #knowledge-base
- #langchain
- #llm
- #mcp
- #model-context-protocol
- #multi-agent
- #openagent
- #openai
- #openclaw
- #rag
About this skill
Pulled from SKILL.md at publish time.
Use `imsg` to read and send iMessage/SMS via macOS Messages.app.
Evaluation report
WarningsAutomated checks the publisher passed at publish time — structure, docs, safety, and whether the artifact behaves as claimed.7211328· 2 weeks ago
Documentation
41Description qualitywarn
11 words · 83 chars — skills use the description as their trigger; aim higher
Aim for 15+ words and include trigger phrases like “use this skill when …”.
README is present and substantial
10,184 chars · 7 sections · 4 code blocks
Tags / topics declared
19 total — agent, agentic, agentic-ai, agi, chatbot, chatgpt (+13)
README has usage / example sections
found: Quick Start
Homepage / docs URL declared
https://www.openagentai.org/
Release history
1- releasecurrent7211328warn2 weeks ago
Contents
Use imsg to read and send iMessage/SMS via macOS Messages.app.
When to Use
✅ USE this skill when:
- User explicitly asks to send iMessage or SMS
- Reading iMessage conversation history
- Checking recent Messages.app chats
- Sending to phone numbers or Apple IDs
When NOT to Use
❌ DON'T use this skill when:
- Telegram messages → use
messagetool withchannel:telegram - Signal messages → use Signal channel if configured
- WhatsApp messages → use WhatsApp channel if configured
- Discord messages → use
messagetool withchannel:discord - Slack messages → use
slackskill - Group chat management (adding/removing members) → not supported
- Bulk/mass messaging → always confirm with user first
- Replying in current conversation → just reply normally (OpenClaw routes automatically)
Requirements
- macOS with Messages.app signed in
- Full Disk Access for terminal
- Automation permission for Messages.app (for sending)
Common Commands
List Chats
imsg chats --limit 10 --json
View History
# By chat ID
imsg history --chat-id 1 --limit 20 --json
# With attachments info
imsg history --chat-id 1 --limit 20 --attachments --json
Watch for New Messages
imsg watch --chat-id 1 --attachments
Send Messages
# Text only
imsg send --to "+14155551212" --text "Hello!"
# With attachment
imsg send --to "+14155551212" --text "Check this out" --file /path/to/image.jpg
# Specify service
imsg send --to "+14155551212" --text "Hi" --service imessage
imsg send --to "+14155551212" --text "Hi" --service sms
Service Options
--service imessage— Force iMessage (requires recipient has iMessage)--service sms— Force SMS (green bubble)--service auto— Let Messages.app decide (default)
Safety Rules
- Always confirm recipient and message content before sending
- Never send to unknown numbers without explicit user approval
- Be careful with attachments — confirm file path exists
- Rate limit yourself — don't spam
Example Workflow
User: "Text mom that I'll be late"
# 1. Find mom's chat
imsg chats --limit 20 --json | jq '.[] | select(.displayName | contains("Mom"))'
# 2. Confirm with user
# "Found Mom at +1555123456. Send 'I'll be late' via iMessage?"
# 3. Send after confirmation
imsg send --to "+1555123456" --text "I'll be late"
Reviews
No reviews yet. Be the first.
Related
Gpt Researcher
An autonomous agent that conducts deep research on any data using any LLM providers
orchestration-patterns
>
migration-patterns
>
mh install skills/imsg