Set up Turn Zero Tools in Codex #
On this page
Before adding or changing a connection, check whether start works and the tzTrack or tzMesh tools you need are available. Reuse a working turnzero connection. Ask once before changing the setup. In a managed workspace, give the person the host's connector steps. A command run inside the workspace does not configure the host.
Use https://turnzero.ai/mcp, named turnzero, for Claude Code and Codex. This connection provides tzCloud, tzTrack and tzMesh tools within your account’s access. A desktop or editor that shares the CLI configuration reuses it; add no second connection there.
Reuse an existing connection that provides the tools you need. Before changing it, check its address and whether your current session can load its tools.
For a picture, call generate_image with a prompt. You need no application. The picture stays in your account for seven days; download it before then. Generate an image with your AI assistant explains the download link and how to renew it.
Codex CLI or editor extension #
After approval, add turnzero from a terminal. Use this address:
codex mcp add turnzero --url "https://turnzero.ai/mcp"
The person completes browser sign-in while the command waits. If it finishes without signing them in, run codex mcp login turnzero. If you're the AI, keep a waiting sign-in running and poll it. Give it at least five minutes before treating silence as a problem. If the browser cannot open, give the person the authorization link. Keep tokens and callback URLs out of chat.
Codex desktop app #
If the desktop app shares your CLI configuration, reuse turnzero and start a new conversation. Otherwise, follow the desktop connector steps. A separately configured desktop connection may be absent from codex mcp list.
Check in a new conversation #
Start a new Codex conversation so it loads the tools, then paste:
Check my Turn Zero connection. Call start, then check that tzTrack and tzMesh tools are available. If a call fails or a tool is unavailable, tell me what happened.