@wirebox-sh/mcp
Allows AI agents to send iMessages, list active conversations, and fetch message history through the Wirebox iMessage router.
Click on "Deploy 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., "@@wirebox-sh/mcp Send a follow-up email to my colleague about the project timeline."
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.
@wirebox-sh/mcp
Official Model Context Protocol (MCP) server for Wirebox — Real-world identity and communication layer for autonomous AI agents.
Equip Claude Desktop, Claude Code, Cursor, Windsurf, Zed, Muse, and custom agent harnesses with real-world communication tools: iMessage (Blue Bubbles), Mailbox (Email), and Agent Identity Management.
1. Quickstart
Option A: Hosted Remote URL (Zero-Install, Recommended for Cursor & Web)
Directly connect via Streamable HTTP — no Node.js or local package installation required:
{
"mcpServers": {
"wirebox": {
"url": "https://api.wirebox.sh/api/v1/mcp",
"headers": {
"Authorization": "Bearer wb_live_..."
}
}
}
}Tip: Cursor also supports appending your key directly to the URL: https://api.wirebox.sh/api/v1/mcp?apiKey=wb_live_...
Option B: Run via npx (Local Stdio Bridge)
npx -y @wirebox-sh/mcpOption C: Claude Desktop Configuration (Stdio)
Add the following to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"wirebox": {
"command": "npx",
"args": ["-y", "@wirebox-sh/mcp"],
"env": {
"WIREBOX_API_KEY": "wb_live_...",
"WIREBOX_IDENTITY": "your-agent-handle"
}
}
}
}Option D: Cursor / Windsurf (Stdio)
Add to .cursor/mcp.json or your Cursor Settings:
{
"mcpServers": {
"wirebox": {
"command": "npx",
"args": ["-y", "@wirebox-sh/mcp"],
"env": {
"WIREBOX_API_KEY": "wb_live_...",
"WIREBOX_IDENTITY": "your-agent-handle"
}
}
}
}Option E: Claude Code
claude mcp add wirebox -- npx -y @wirebox-sh/mcpOr install as a plugin from the repository root:
/plugin install wireboxRelated MCP server: hauddy
2. Environment Variables
Variable | Required | Description |
| Yes | Your Wirebox secret API key (starts with |
| No | Default agent handle (e.g. |
| No | Override the API base URL (defaults to |
| No | Set to |
3. Available Tools
Identity Tools
wirebox_whoami: Show this agent's Wirebox identity (handle, email address, display name) and iMessage router connection status.
iMessage Tools
wirebox_imessage_send: Send an iMessage (blue bubble). Reply into an existing conversation viaconversationId, or initiate to an E.164 phone number / Apple ID email.wirebox_imessage_list_conversations: List active iMessage conversations, participant handles, unread counts, and last message timestamps.wirebox_imessage_get_messages: Fetch message history for a specific iMessage conversation.
Mail Tools
wirebox_mail_send: Send an email from the agent's identity mailbox (to,subject,body).wirebox_mail_list: List email messages in the agent's mailbox (folder,limit,offset).wirebox_mail_search: Full-text search across the mailbox, ranked by relevance (query,limit).
4. Development & Testing
# Install dependencies
npm install
# Run test suite
npm test
# Typecheck
npm run typecheck
# Build bundle
npm run build5. License
MIT © Wirebox
Available Tools
6 toolswirebox_imessage_get_messagesA
Fetch message history for a specific iMessage conversation.
Inputs: conversationId (required), limit, cursor, identity.
wirebox_imessage_list_conversationsA
List active iMessage conversations for this agent, including participants, last message timestamp, and unread count.
Inputs: limit, cursor, identity.
wirebox_imessage_sendA
Send an iMessage. Reply into an existing conversation via conversationId, or start a message to a recipient E.164 phone number / Apple ID email.
Inputs: text (required), to, identity, conversationId.
wirebox_mail_listB
List email messages in this agent's mailbox.
Inputs: limit, offset, status, identity.
wirebox_mail_sendA
Send an email message from this agent's Wirebox mailbox.
Inputs: to (required), body (required), subject (required), identity.
wirebox_whoamiA
Show this agent's Wirebox identity (handle, email address, display name) and iMessage router connection status.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct action: sending vs listing emails, sending iMessages, listing conversations, fetching message history, and getting identity/status. There is no overlap between tools that could cause an agent to select the wrong one.
All tools follow a consistent wirebox_{channel}_{action} pattern with snake_case. Minor inconsistency exists: mail_list doesn't specify what is listed (messages), while imessage uses list_conversations and get_messages, but the pattern is still predictable.
Six tools is well-scoped for a messaging server covering two channels (email and iMessage) plus identity/status. Each tool has a clear purpose and none are redundant.
Core messaging workflows are supported: send and list email, send iMessage, list conversations, and fetch messages. Minor gaps exist such as no single-email fetch, no email reply, or no mark-as-read, but agents can accomplish primary tasks.
Maintenance
Related MCP Connectors
Email and optional phone for AI agents: send, receive, search, draft and call over MCP.
Email infrastructure for AI agents — send, receive, search, and reply to email over MCP.
Phone, SMS and email for AI agents. One remote MCP endpoint, OAuth login, zero install.
Give AI agents real phone numbers, messages, and voice calls via MCP.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading and sending iMessages on macOS through MCP, with tools for managing chats, messages, and attachments via AI agents.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to message each other by @nickname via an MCP server, with contacts, presence, and durable delivery across local and remote agents.2Apache 2.0
- AlicenseNot gradedqualityCmaintenanceEnables MCP agents to send and receive iMessages via BlueBubbles, allowing human-in-the-loop oversight and replies from a phone.MIT
- AlicenseNot gradedqualityBmaintenanceEnables connecting AI assistants to iMessage, WhatsApp, and A2A agents through a single MCP server.7MIT