> ## Documentation Index
> Fetch the complete documentation index at: https://sendmux.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Claude Code MCP setup

> Configure Sendmux MCP in Claude Code.

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

## Hosted OAuth

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

```text theme={null}
https://mcp.sendmux.ai/mcp
```

```bash theme={null}
claude mcp add sendmux --transport http https://mcp.sendmux.ai/mcp
```

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

## Local stdio

Install the local package once:

```bash theme={null}
pip install sendmux-mcp
```

Use a mailbox key for Mailbox or Sending:

```bash theme={null}
export SENDMUX_MBX_KEY=smx_mbx_...
```

Use a root key for Management:

```bash theme={null}
export SENDMUX_ROOT_KEY=smx_root_...
```

```bash theme={null}
claude mcp add sendmux-mailbox \
  --transport stdio \
  --env SENDMUX_API_KEY="$SENDMUX_MBX_KEY" \
  -- sendmux-mcp-mailbox
```

## Private HTTP

Start a local HTTP MCP server:

```bash theme={null}
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.

```bash theme={null}
claude mcp add sendmux-local \
  --transport http \
  --header "Authorization: Bearer local-mcp-token" \
  http://127.0.0.1:8765/mcp
```