How do I install the Imessage Smart skill?

Run npx skillmds@latest add meleantonio/imessage-smart in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Imessage Smart safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Imessage Smart?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Imessage Smart free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Imessage Smart?

meleantonio (@meleantonio) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Imessage Smart by meleantonio — Agent Skill

Name: Imessage Smart
Author: meleantonio

Imessage Smart

Reads recent iMessage history from the local Messages database and sends iMessages via AppleScript. Use when the user asks to text someone, check conversation context before replying, or send an iMessage from a self-hosted Cursor agent on macOS.

meleantonio 2dfa692 3 files · 6.8 KB Updated Sep 17, 2026

File contents

iMessage (smart)

When to use

Before composing a reply, read recent messages so responses match thread context.
When the user names a person or phone/email — match handle_id or chat display name with the read script.
After the user confirms wording, send with the send script.

Prerequisites

macOS with Messages / iMessage signed in.
Full Disk Access for the app running the agent (Terminal, Cursor, or agent worker) so ~/Library/Messages/chat.db is readable.
Recipient for send: phone in E.164 (e.g. +46701234567) or Apple ID email.

Scripts (from repo `workstation/` root)

Read recent messages (JSON on stdout):

python3 workstation/.cursor/skills/imessage-smart/scripts/read_recent_messages.py \
  --contact "+4670..." --limit 15

Send a message:

python3 workstation/.cursor/skills/imessage-smart/scripts/send_imessage.py \
  --to "+4670..." --body "Your text here"

Paths: if the skill lives under workstation/.cursor/skills/imessage-smart/, resolve workstation as the directory containing .cursor.

Agent workflow

Run read with a distinctive substring of the handle (phone/email) or display name.
Summarize thread for the user; propose a reply draft.
On approval, run send with the same handle format Messages expects.

Safety

Do not send unsolicited or sensitive content; confirm with the user when unclear.
If chat.db errors occur, suggest Full Disk Access and that Messages may need to be quit for heavy read contention.

Frequently asked questions