Optional add-on for imessage-mcp: exposes a send_message tool so MCP clients can also send iMessages.
Project description
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file imessage_mcp_send-0.1.1.tar.gz.
File metadata
- Download URL: imessage_mcp_send-0.1.1.tar.gz
- Upload date:
- Size: 3.6 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
008f809a72e13d3c1be31e0ea7a361d48bd34f14f609d447a3ecea3597e9c5e2
|
|
| MD5 |
dc1fb9eeb25cf45bd444b8115d59cfd1
|
|
| BLAKE2b-256 |
26b629edaf91927f1d4b2940de02bf55cd4d57a16aac40d6c2572223e587bcf6
|
File details
Details for the file imessage_mcp_send-0.1.1-py3-none-any.whl.
File metadata
- Download URL: imessage_mcp_send-0.1.1-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d7c10cb4ecb722d3237345f0d543d49acb5ca65cf4ecf59cd6ac744d2675a33b
|
|
| MD5 |
100a67a8afe7e6e119f74f490021d614
|
|
| BLAKE2b-256 |
69c1fcf5a6f9aa601527ead7ab0d08054eb3538ee2049c980a35cb9b40377030
|
