Set up AIRO Connect in Codex CLI
You can set up AIRO Connect in Codex CLI using OAuth 2.0 or an API token.
Before you begin
You need a Workato account with AIRO access and Codex CLI installed. API token authentication also requires a Workato API token. Refer to Create an API token for instructions.
Connect with OAuth 2.0
Complete the following steps to connect Codex CLI to AIRO Connect using OAuth 2.0:
Open your terminal.
Add AIRO Connect, using the URL for your data center:
codex mcp add workato-airo-mcp-server \
--url https://YOUR_DATA_CENTER/airo_mcpFor example, on the US data center, the URL is https://app.workato.com/airo_mcp.
Sign in to Workato in the browser window that opens if prompted, then click Authorize. If the browser doesn't open or the authorization flow doesn't start, run codex mcp login workato-airo-mcp-server.
Verify that the server is configured:
codex mcp listThe output should include workato-airo-mcp-server.
Start a new Codex session so the MCP server and its tools are initialized:
codexInside Codex, enter /mcp to inspect the active MCP servers.
Confirm the server responds by prompting Codex. For example, List my Workato projects.
Refer to Codex's MCP documentation for more configuration options.
Connect with an API token
Complete the following steps to connect Codex CLI to AIRO Connect using an API token:
Open your terminal.
Add the following line to your shell profile (~/.zshrc, ~/.bashrc, ~/.bash_profile, or equivalent), replacing <YOUR_API_TOKEN> with the API token you generated:
export WORKATO_API_TOKEN="<YOUR_API_TOKEN>"Reload your shell profile:
source ~/.zshrc # Replace with the profile file you editedOptional. Confirm that the environment variable is available without displaying the token:
test -n "$WORKATO_API_TOKEN" && echo "WORKATO_API_TOKEN is set"Add AIRO Connect, using the URL for your data center and referencing the environment variable that contains the bearer token:
codex mcp add workato-airo-mcp-server \
--url https://YOUR_DATA_CENTER/airo_mcp \
--bearer-token-env-var WORKATO_API_TOKENFor example, on the US data center, the URL is https://app.workato.com/airo_mcp.
The --bearer-token-env-var option stores the environment variable's name in the Codex configuration, not the token itself.
Verify that the server is configured:
codex mcp listThe output should include workato-airo-mcp-server.
Start a new Codex session so the newly configured MCP server is initialized:
codexInside Codex, enter /mcp to inspect the active MCP servers.
Confirm the server responds by prompting Codex. For example, List my Workato projects.
Refer to Codex's MCP documentation for more configuration options.
Connect another workspace or environment
Add a separate AIRO Connect server entry to your client configuration for each workspace or environment you need to access at the same time, using a unique server name and a separate API token for every entry.
Repeat the steps in Connect with an API token, using a different server name in place of workato-airo-mcp-server and a different environment variable name in place of WORKATO_API_TOKEN for each entry.
Last updated: