# Codex Desktop + Render: Deploy and manage your Render apps from Codex Desktop.

[Codex Desktop](https://developers.openai.com/codex/app/) 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.

## Setup contract

- Preferred setup method: Codex Desktop plugin
- Preferred setup command: `Plugins → Render → Install`
- MCP provided by: Render plugin
- Config file: `~/.codex/config.toml`
- Manual OAuth command: `With Codex CLI installed: codex mcp add render --url https://mcp.render.com/mcp --oauth-client-id codex`
- API key fallback command: `With Codex CLI installed: codex mcp add render --url https://mcp.render.com/mcp --bearer-token-env-var RENDER_API_KEY`
- OAuth client ID: `codex`
- API key environment variable: `RENDER_API_KEY`
- Skills supported: Yes
- Skills command: `Plugins → Render → Install`
- Skills fallback command: `npx skills add render-oss/skills`
- Skills directory: `Plugin-managed; ~/.codex/skills/ for standalone skills`
- Auth: OAuth
- Restart required: No
- Verify: `list_workspaces`
- Fallback reference: [Full setup details](https://render.com/docs/mcp-server.md#codex-desktop-and-cli-setup)

## 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 install command: `Plugins → Render → Install`
- MCP 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](/docs/mcp-server) for manual and API-key alternatives. Use the [Codex CLI guide](/agents/codex) for terminal-only setup.

## Example prompts

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