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

# How to Install the Pleo MCP in Codex

> Step-by-step instructions for connecting the Pleo MCP to OpenAI's Codex.

export const NoteCallout = ({title, children}) => <div className="callout-box callout-note">
    <div className="callout-row">
      <span className="callout-icon">
        <svg width="22" height="22" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 256 256" fill="currentColor"><path d="M208,104a79.86,79.86,0,0,1-30.59,62.92A24.29,24.29,0,0,0,168,186v6a8,8,0,0,1-8,8H96a8,8,0,0,1-8-8v-6a24.11,24.11,0,0,0-9.3-19A79.87,79.87,0,0,1,48,104.45C47.76,61.09,82.72,25,126.07,24A80,80,0,0,1,208,104Z" opacity="0.2" /><path d="M176,232a8,8,0,0,1-8,8H88a8,8,0,0,1,0-16h80A8,8,0,0,1,176,232Zm40-128a87.55,87.55,0,0,1-33.64,69.21A16.24,16.24,0,0,0,176,186v6a16,16,0,0,1-16,16H96a16,16,0,0,1-16-16v-6a16,16,0,0,0-6.23-12.66A87.59,87.59,0,0,1,40,104.49C39.74,56.83,78.26,17.14,125.88,16A88,88,0,0,1,216,104Zm-16,0a72,72,0,0,0-73.74-72c-39,.92-70.47,33.39-70.26,72.39a71.65,71.65,0,0,0,27.64,56.3A32,32,0,0,1,96,186v6h64v-6a32.15,32.15,0,0,1,12.47-25.35A71.65,71.65,0,0,0,200,104Zm-16.11-9.34a57.6,57.6,0,0,0-46.56-46.55,8,8,0,0,0-2.66,15.78c16.57,2.79,30.63,16.85,33.44,33.45A8,8,0,0,0,176,104a9,9,0,0,0,1.35-.11A8,8,0,0,0,183.89,94.66Z" /></svg>
      </span>
      <div>
        {title && <div className="callout-title">
            {title}
          </div>}
        <div className="callout-body">
          {children}
        </div>
      </div>
    </div>
  </div>;

This page is for developers connecting Codex CLI to Pleo by editing their local configuration file.

## Prerequisites

Before you begin:

* Pleo MCP access is off by default; a company admin must enable it for your organisation before you can connect. See [Access & Permissions](/docs/current/pleo-mcp/get-started/access-and-permissions) if you're not sure whether it's enabled.
* If you use Codex through a ChatGPT Business or Enterprise workspace that restricts custom connectors, your workspace admin has allowed Pleo. See [How to Add Pleo MCP as a Custom Connector in ChatGPT](/docs/current/pleo-mcp/how-tos/enablement/chatgpt) if you're not sure.

## Steps

Follow the steps below to connect Pleo to Codex. Codex CLI reads its MCP server configuration from `~/.codex/config.toml`.

1. Add a Pleo entry to `~/.codex/config.toml`, either by editing the file directly or with the `codex mcp add` command:

```bash theme={null}
codex mcp add pleo-mcp --url https://mcp.pleo.io/mcp
```

This adds a block like the following to your config file:

```toml theme={null}
[mcp_servers.pleo-mcp]
url = "https://mcp.pleo.io/mcp"
```

2. Authorise the connection:

```bash theme={null}
codex mcp login pleo-mcp
```

This opens your browser for OAuth authorisation. Log in to Pleo if needed, then approve access.

3. Run `codex mcp list` to confirm `pleo-mcp` is configured and connected.

You are now connected and can start using the Pleo MCP in Codex.

<NoteCallout title="OAuth requires an explicit login step">
  Unlike some MCP clients, Codex doesn't prompt for OAuth automatically the first time a tool is called. You must run `codex mcp login <name>` yourself after adding the server. Use `codex mcp logout pleo-mcp` to remove stored credentials if you need to reconnect.
</NoteCallout>

***

## Related Reading

* **OpenAI's documentation:** [Model Context Protocol – Codex](https://developers.openai.com/codex/mcp)
* [Install the Pleo MCP: Choose Your AI Tool](/docs/current/pleo-mcp/how-tos/installation/overview)
* [How to Add Pleo MCP as a Custom Connector in Codex](/docs/current/pleo-mcp/how-tos/enablement/codex)
* [How to Revoke Access to the Pleo MCP](/docs/current/pleo-mcp/how-tos/uninstallation/revoke-access)

***