> ## Documentation Index
> Fetch the complete documentation index at: https://docs.augent.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex Setup

> Connect Augent to OpenAI Codex so it can download, transcribe, and search audio natively.

## Config file (recommended)

Add Augent to your Codex config:

<Tabs>
  <Tab title="macOS / Linux">
    Edit `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.augent]
    command = "augent-mcp"
    ```
  </Tab>

  <Tab title="Windows (WSL2)">
    Edit `~/.codex/config.toml`:

    ```toml theme={null}
    [mcp_servers.augent]
    command = "augent-mcp"
    ```

    If `augent-mcp` isn't found, use the full path:

    ```toml theme={null}
    [mcp_servers.augent]
    command = "python3"
    args = ["-m", "augent.mcp"]
    ```
  </Tab>
</Tabs>

## GUI (desktop app)

1. Open **Codex** on your Mac
2. Go to **Settings** (gear icon, bottom left)
3. Click **MCP Servers**
4. Click **Add new MCP server**
5. Fill in the fields:

| Field       | Value        |
| :---------- | :----------- |
| **Name**    | `augent`     |
| **Command** | `augent-mcp` |

6. Toggle the server **on**
7. Start a new conversation and all 21 tools are available

## Codex CLI

```bash theme={null}
codex --mcp augent=augent-mcp
```

Or set it permanently in your config file as shown above.

## Verify

Start a new Codex conversation. All 20 Augent tools should be visible and ready to use.

Try a quick test:

```
Take notes from https://www.youtube.com/watch?v=dQw4w9WgXcQ
```

***

<CardGroup cols={2}>
  <Card title="Claude Code Setup" icon="plug" href="/getting-started/claude-code-setup">
    Connect Augent to Claude Code
  </Card>

  <Card title="OpenClaw Setup" icon="lobster" href="/getting-started/openclaw-setup">
    All Augent tools with OpenClaw
  </Card>
</CardGroup>