imessage-send-mcp

A minimal MCP server that sends iMessages via the macOS Messages app using osascript. No Full Disk Access required — write-only, never reads your message history.

What it does

Exposes one tool to Claude Code (or any MCP client):

• `send_imessage(recipient, message)` — sends an iMessage or SMS to a phone number or Apple ID email

Requirements

• macOS (uses osascript + Messages app)
• Messages app must be open and signed in to iMessage
• Python 3.11+

Installation

pip install imessage-send-mcp

Or from source:

git clone https://github.com/andyjianzhou/imessage-send-mcp
cd imessage-send-mcp
pip install -e ".[dev]"

Add to Claude Code

claude mcp add-json "imessage-send" '{
  "command": "python3",
  "args": ["-m", "imessage_send_mcp.server"]
}'

Then restart Claude Code. The send_imessage tool will be available in your next session.

Usage

Once connected, Claude can send messages like:

send_imessage("+14155551234", "Hello from Claude!")

Recipients can be:

• Phone number in E.164 format: +14155551234
• Apple ID email: [email protected]

Security

• No Full Disk Access needed — this server only sends messages, never reads chat.db
• No network requests — runs entirely locally via AppleScript
• Minimal surface area — ~50 lines of code, fully auditable

Development

pip install -e ".[dev]"
pytest          # run tests
ruff check .    # lint
mypy src        # type check

License

MIT