Claude Code MCP setup

Use this page to connect Sendmux MCP to your AI client.

Hosted OAuth

Use the hosted endpoint when the client supports remote MCP OAuth:

https://mcp.sendmux.ai/mcp

claude mcp add sendmux --transport http https://mcp.sendmux.ai/mcp

Use /mcp in Claude Code if the server is listed as requiring authentication.

Install the local package once:

pip install sendmux-mcp

Use a mailbox key for Mailbox or Sending:

export SENDMUX_MBX_KEY=smx_mbx_...

Use a root key for Management:

export SENDMUX_ROOT_KEY=smx_root_...

claude mcp add sendmux-mailbox \
  --transport stdio \
  --env SENDMUX_API_KEY="$SENDMUX_MBX_KEY" \
  -- sendmux-mcp-mailbox

Start a local HTTP MCP server:

SENDMUX_API_KEY=smx_mbx_... \
SENDMUX_MCP_HTTP_BEARER_TOKEN=local-mcp-token \
sendmux-mcp-mailbox --transport http --host 127.0.0.1 --port 8765

Use http://127.0.0.1:8765/mcp as the client URL.

claude mcp add sendmux-local \
  --transport http \
  --header "Authorization: Bearer local-mcp-token" \
  http://127.0.0.1:8765/mcp