Allows sending iMessage text messages to a specified recipient via macOS Messages, with rate limiting and urgency options.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@imessage-mcp Send me an iMessage that you need my decision on the refund amount."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A minimal MCP server with one tool, text_user, that sends an iMessage to a
configured handle. macOS only, Node 18+.
It is only a channel. When an agent should text you, and how often, is for your harness or agent config to decide, not this server.
npm install && npm run buildRequirements on the machine running the server:
IMESSAGE_HANDLE set to the recipient's phone number in E.164 form
(+11234567890) or their Apple ID email
Messages.app signed in to iMessage
Automation permission for Messages (System Settings > Privacy & Security > Automation). macOS prompts once on the first send.
Related MCP server: iMessage Max
claude mcp add imessage --env IMESSAGE_HANDLE=+11234567890 -- node /absolute/path/to/imessage-mcp/dist/index.jstext_userOne required field, message (string), sent verbatim. Returns { sent: true },
or an error string explaining why it wasn't sent. It never throws.
Sending is one-way: no receive path, no chat.db reading, no contact lookup,
no other tools.
src/send.applescript is a fixed script file, invoked with the message and
handle as arguments, so message content is never interpolated into its source.
It omits activate, so sending won't steal focus.
This server cannot be installed
Unclaimed servers have limited discoverability.
If you are the server author, to access and configure the admin panel.
Reach your own phone from an AI agent: notifications, approval questions, reminders, ring, files.
Push notifications for AI agents - send instant iPhone notifications from any MCP client.
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Let your AI agent notify you by email, Slack, Discord, or webhook. One tool: send_notification.
