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-mcpOr 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:
example@icloud.com
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 checkLicense
MIT
