Migrating production infrastructure? Get up to $10K in migration credits.

Apply now
Back to agents

Codex Desktop + Render

Deploy and manage your Render apps from Codex Desktop.

Codex Desktop is the Codex experience in the ChatGPT desktop app. The Render plugin gives it Render skills and live access to services, deploys, logs, metrics, and databases.

Quick start

  1. Install or update the ChatGPT desktop app, then select Codex.

  2. Install the Render plugin. Open Plugins, search for Render, and select Install.

  3. Connect with OAuth. Start a new Codex thread, use a Render MCP tool, and approve the browser prompt. No Render API key is required.

  4. Verify the connection. Ask Codex to run list_workspaces, choose a workspace if needed, then try "Deploy this project to Render."

MCP and authentication

MCP setup
Install command
Plugins → Render → Install
Config file
~/.codex/config.toml
OAuth
Supported

The plugin provides https://mcp.render.com/mcp with a pre-registered OAuth client. Codex Desktop and Codex CLI share ~/.codex/config.toml, so a manual MCP configuration is available in both clients.

See the MCP server docs for manual and API-key alternatives. Use the Codex CLI guide for terminal-only setup.

Example prompts

Start with one of these prompts, then refine the plan with your agent.

Deploy

Deploy this project to Render and explain the Blueprint before applying it.

Debug

Check the latest failed deploy, fix the cause, and verify the next deploy.

Database

Create a Render Postgres database and connect it to this service with DATABASE_URL.

Status

Summarize the health, recent deploys, and error logs for my Render services.

Common workflows

Deploy a project

  • Ask Codex to inspect the repository and propose a render.yaml Blueprint.
  • Review the services, databases, and environment variables.
  • Apply the plan, then check the first deploy.

Debug a failed deploy

  • Ask Codex to fetch the latest failed deploy logs.
  • Let it identify and fix the code, configuration, or environment issue.
  • Verify the next deploy reaches a healthy state.

Add a database

  • Ask Codex to create a Render Postgres database.
  • Store its internal connection string as DATABASE_URL.
  • Add migrations to the service's pre-deploy command.
Other coding agents that pair well with Render.