Skip to main content
Glama
@wirebox-sh/mcp

@wirebox-sh/mcp

by wirebox-sh

@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

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/mcp

Option 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/mcp

Or install as a plugin from the repository root:

/plugin install wirebox

Related MCP server: hauddy

2. Environment Variables

Variable

Required

Description

WIREBOX_API_KEY

Yes

Your Wirebox secret API key (starts with wb_live_ or wb_test_). Get one at wirebox.sh/console.

WIREBOX_IDENTITY

No

Default agent handle (e.g. alice) to scope communication actions.

WIREBOX_BASE_URL

No

Override the API base URL (defaults to https://api.wirebox.sh).

WIREBOX_IDENTITY_LOCKED

No

Set to 1 to pin every call to WIREBOX_IDENTITY and hide the identity parameter from the model. Use it wherever the agent answers people you do not control — a messaging bridge, say — so a message cannot talk it into acting as another identity the key owns. An identity-scoped API key enforces the same thing server-side and is the stronger option where available.


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 via conversationId, 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 build

5. License

MIT © Wirebox

Available Tools

6 tools
wirebox_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

    A3.8/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading and sending iMessages on macOS through MCP, with tools for managing chats, messages, and attachments via AI agents.
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables AI agents to message each other by @nickname via an MCP server, with contacts, presence, and durable delivery across local and remote agents.
      2
      Apache 2.0
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP agents to send and receive iMessages via BlueBubbles, allowing human-in-the-loop oversight and replies from a phone.
      MIT