---
url: https://chartbuddy.io/hub/docs/connect-mcp/chatgpt-codex.md
---
> Docs index: [llms.txt](https://chartbuddy.io/hub/docs/llms.txt)


# Connect ChatGPT / Codex

This page is for **Codex CLI** and the **Codex** tab in the ChatGPT desktop application. **ChatGPT (web)** – browser chat and regular chat in the desktop app – uses a different path. See [Connect ChatGPT (web)](https://chartbuddy.io/hub/docs/connect-mcp/chatgpt.md).

## Setup via Chartbuddy Hub

1. Install Chartbuddy Hub and launch it once (approve OS security prompts).
2. Open **AI connections** in Hub (title-bar cable icon).

3) Connect **ChatGPT Desktop / Codex CLI**. Hub writes the server into your Codex user config.

4. Restart ChatGPT or Codex, then start a new Codex task so tools load.

## Setup manually

### 1. Open Settings

In the ChatGPT desktop app, click **Settings** in the **bottom-left** corner of the sidebar.

![Click Settings in the bottom-left of ChatGPT Desktop](https://chartbuddy.io/images/chatgpt-mcp/01-click-settings.png)

### 2. Plugins → MCPs

In the settings sidebar, open **Plugins** (under Integrations). Then open the **MCPs** tab.

![Open Plugins, then the MCPs tab](https://chartbuddy.io/images/chatgpt-mcp/02-plugins-then-mcps.png)

### 3. Add server

On the MCPs tab, click **+ Add server**.

![Click Add server on the MCPs tab](https://chartbuddy.io/images/chatgpt-mcp/03-add-server.png)

### 4. Enter the Chartbuddy details

Choose **Connect to a custom MCP** (STDIO). Fields appear in this order – fill in every row:

| Field | Value |
|-------|--------|
| **Name** | `Chartbuddy-Hub` (or `chartbuddy`) |
| **Type** | **STDIO** |
| **Command to launch** | Chartbuddy binary (see OS paths below) |
| **Arguments** | `--mcp` |
| **Environment variables** | leave empty |
| **Working directory** | leave the default |

**Command to launch:**

* macOS: `/Applications/Chartbuddy.app/Contents/MacOS/chartbuddy`
* Windows: `C:\Users\YOUR_USER\AppData\Local\Programs\Chartbuddy\chartbuddy.exe` (replace `YOUR_USER`, or use the path shown after install)

Click **Save**.

![Enter Chartbuddy STDIO command and --mcp argument](https://chartbuddy.io/images/chatgpt-mcp/04-enter-details.png)

## After saving

1. Keep **Chartbuddy Hub** running.
2. Start a **new** Codex session and enable the Chartbuddy MCP server for that session if tools do not appear.
3. If ChatGPT asks to approve **network / loopback** for `chartbuddy`, approve it – the adapter must reach Chartbuddy Hub on `127.0.0.1`.
4. Optional check:

::: code-group

```powershell [Windows]
& "$env:LOCALAPPDATA\Programs\Chartbuddy\chartbuddy.exe" --mcp-status
```

```bash [macOS]
/Applications/Chartbuddy.app/Contents/MacOS/chartbuddy --mcp-status
```

:::

Exit `0` = Chartbuddy Hub is up.

## Troubleshooting

### Tool call blocked – “reasoning summaries” / organization verification

On the desktop **Codex** tab, Chartbuddy may be configured correctly and still fail when OpenAI’s automatic approval reviewer blocks the tool call – often with an error about **“reasoning summaries”** requiring organization verification. That comes from OpenAI’s approval / org settings, **not** from Chartbuddy or a bad MCP path.

**Options:**

1. Use **Codex CLI** instead of the desktop Codex tab (same MCP config, often fewer approval blockers), or
2. Verify your organization at [platform.openai.com/settings/organization/general](https://platform.openai.com/settings/organization/general), **or** switch to another editor – we recommend [Cursor](https://chartbuddy.io/hub/docs/connect-mcp/cursor.md), [Claude Code](https://chartbuddy.io/hub/docs/connect-mcp/claude-code.md), or [OpenCode](https://chartbuddy.io/hub/docs/connect-mcp/opencode.md).