Skip to main content

imessage-mcp-send

Optional add-on for imessage-mcp that adds a send_message MCP tool. With this installed, your MCP client can also send iMessages, not just read them.

Sending is irreversible. Install only if you understand and accept that — and only with an MCP client that surfaces tool calls to you for confirmation before executing them.

Install

uv tool install imessage-mcp-send

This pulls in imessage-mcp as a dependency, so you don't need to install it separately.

Quickstart

imessage-mcp-send setup        # opens the macOS Full Disk Access pane
imessage-mcp-send serve        # MCP server on http://127.0.0.1:8765/mcp
                               # exposes list_chats, read_messages, search_messages, send_message

On first send, macOS will prompt for Automation permission for whatever app is running the CLI (Terminal, iTerm, etc.) to control Messages. Click Allow.

With the broker (imessage-bridge)

Install both:

uv tool install imessage-mcp-send
uv tool install imessage-bridge

imessage-bridge serve --public auto-detects this package and exposes send via your broker URL too.

The new tool

Tool Arguments Purpose
send_message text, recipient?, chat_id? Send to a phone/email or reply to a 1:1 chat. Group chats not supported.

License

MIT

Metadata

Release files for imessage-mcp-send 0.1.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for imessage-mcp-send 0.1.1
File Size Uploaded
imessage_mcp_send-0.1.1.tar.gz 3.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for imessage-mcp-send 0.1.1
File Interpreter ABI Platform
imessage_mcp_send-0.1.1-py3-none-any.whl Python 3 none any Details

Total release size: 8.8 kB

Release files / imessage_mcp_send-0.1.1.tar.gz

Download URL imessage_mcp_send-0.1.1.tar.gz
Size 3.6 kB
Tags Source
SHA-256 checksum
How to use checksums
008f809a72e13d3c1be31e0ea7a361d48bd34f14f609d447a3ecea3597e9c5e2
BLAKE2b-256 checksum
How to use checksums
26b629edaf91927f1d4b2940de02bf55cd4d57a16aac40d6c2572223e587bcf6
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release files / imessage_mcp_send-0.1.1-py3-none-any.whl

Download URL imessage_mcp_send-0.1.1-py3-none-any.whl
Size 5.2 kB
Tags Python 3
SHA-256 checksum
How to use checksums
d7c10cb4ecb722d3237345f0d543d49acb5ca65cf4ecf59cd6ac744d2675a33b
BLAKE2b-256 checksum
How to use checksums
69c1fcf5a6f9aa601527ead7ab0d08054eb3538ee2049c980a35cb9b40377030
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.11.2 {"installer":{"name":"uv","version":"0.11.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

Release history Release notifications | RSS feed

This release

0.1.1 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page