Codex 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

Add this to ~/.codex/config.toml or a trusted project .codex/config.toml.

[mcp_servers.sendmux]
url = "https://mcp.sendmux.ai/mcp"

Then authenticate:

codex mcp login sendmux

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_...

Run Codex with SENDMUX_API_KEY already set, then use env_vars so the value stays outside the config file.

[mcp_servers.sendmux_mailbox]
command = "sendmux-mcp-mailbox"
env_vars = ["SENDMUX_API_KEY"]

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.

[mcp_servers.sendmux_local]
url = "http://127.0.0.1:8765/mcp"
bearer_token_env_var = "SENDMUX_MCP_HTTP_BEARER_TOKEN"