---
title: "Use Cool Computers with Codex"
description: "Paste the setup prompt into Codex, or install the Cool Computers plugin from the plugin directory."
canonical: "https://www.cool.computer/docs/agents/codex"
last_updated: "2026-11-20"
---
# Use Cool Computers with Codex

> Paste the setup prompt into Codex, or install the Cool Computers plugin from the plugin directory.

## Paste this

Paste this prompt into Codex:

```text wrap
set up cool computers for me: follow https://cool.computer/setup.md and build me an artifact about the last thing i was working on, and annotate and draw on it once i'm signed up
```

[Open Codex](codex://new?prompt=set%20up%20cool%20computers%20for%20me%3A%20follow%20https%3A%2F%2Fcool.computer%2Fsetup.md%20and%20build%20me%20an%20artifact%20about%20the%20last%20thing%20i%20was%20working%20on%2C%20and%20annotate%20and%20draw%20on%20it%20once%20i'm%20signed%20up): Opens Codex in the ChatGPT desktop app with the prompt typed in. Nothing runs until you send it.

Codex installs `cool` and puts an artifact about your last work online. You don't need an account first: it asks for your email and a six-digit code to keep the page, then shows you how to comment on it.

## Connect it yourself

Install the Cool Computers plugin from the plugin directory that Codex shares with ChatGPT. It adds the MCP server and the [`cool-computers` skill](/docs/agents/overview#teach-your-agent).

1. In the Codex CLI, run `/plugins`. In the ChatGPT desktop app, open **Plugins**.
2. Find Cool Computers and install it. In the desktop app, choose **+**.
3. Start a new session, or a new Codex chat in the desktop app. Codex asks you to sign in to Cool Computers, or sign up.

The plugin marks its server `required`, so Codex waits for the Cool Computers tools before a task starts instead of running without them.

### Add it by hand

Install the plugin from its [GitHub marketplace](https://github.com/The-Money-Company-Limited/cool-computers) instead:

```sh
codex plugin marketplace add The-Money-Company-Limited/cool-computers && codex plugin add cool-computers@cool-computers
```

### MCP server only

```sh
codex mcp add cool-computers --url https://api.cool.computer/mcp
```

Codex opens the browser to sign in, or sign up. `codex mcp login cool-computers` signs in again later.

Then add `required = true` under `[mcp_servers.cool-computers]` in `~/.codex/config.toml`. Codex then waits for the Cool Computers tools before a task starts, and stops with an error if it cannot connect. The Codex CLI, the IDE extension, and the ChatGPT desktop app share this file.

To use an API key instead of signing in, keep the key in `COOL_API_KEY` and add the server with `--bearer-token-env-var COOL_API_KEY`. [Other MCP clients](/docs/agents/other-mcp-clients#with-an-api-key) shows how to create one.

## Check it works

Ask Codex:

```text
List my Cool Computers sites and computers. Don't change anything.
```

It answers with your list. If you added the MCP server and it doesn't, run `codex mcp list` to confirm that `cool-computers` is enabled.
