Skip to main content

Quick install (macOS)

Run the following command to install Unblocked MCP:
curl -fsSL https://getunblocked.com/install-mcp.sh | bash
This will download the Unblocked CLI and configure your supported tools and agents automatically.
The install script is currently supported on macOS only. Windows and Linux users should use the manual install instructions below.

Manual install (macOS, Windows, Linux)

You can connect Codex to remote Unblocked MCP with the following command:
codex mcp add unblocked --url https://getunblocked.com/api/mcpsse
After adding the server, log in to Unblocked via OAuth:
codex mcp login unblocked
Codex will launch a browser to authenticate with Unblocked. Alternatively, you can add the server manually by editing the config file:
  • macOS / Linux: ~/.codex/config.toml
  • Windows: %USERPROFILE%\.codex\config.toml
[mcp_servers.unblocked]
url = "https://getunblocked.com/api/mcpsse"