> ## 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, icon = "💡"}) => <div style={{
  backgroundColor: 'var(--recommended-bg)',
  borderLeft: '4px solid #3beaf6',
  borderRadius: '10px',
  padding: '18px 22px',
  marginBottom: '20px',
  boxShadow: '1px 1px 3px rgba(0,0,0,0.06)'
}}>
    <div style={{
  display: 'flex',
  alignItems: 'flex-start',
  gap: '14px'
}}>
      <span style={{
  fontSize: '22px',
  lineHeight: '1',
  flexShrink: 0
}}>
        {icon}
      </span>
      <div>
        {title && <div style={{
  fontSize: '16px',
  fontWeight: 600,
  color: 'var(--recommended-title)',
  marginBottom: '6px'
}}>
            {title}
          </div>}
        <div style={{
  fontSize: '14px',
  lineHeight: 1.65
}}>
          {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)

***