Skip to main content

​
Overview

Use the remote oleander MCP server in OpenAI Codex to connect your agent workflows directly to oleander.
Beta: MCP integration docs and workflow may change.

​
Prerequisites

  • OpenAI Codex CLI installed

​
Add the MCP server

Add the oleander server to your Codex config at ~/.codex/config.json: 
{
  "mcpServers": {
    "oleander": {
      "type": "streamableHttp",
      "url": "https://oleander.dev/mcp"
    }
  }
}
If you already have other MCP servers configured, add only the oleander entry under mcpServers.

​
Authenticate

On first use, Codex will prompt you to complete an OAuth flow in your browser to authorize access with your oleander account. Alternatively, you can pass your oleander API key as a bearer token in the server config: 
{
  "mcpServers": {
    "oleander": {
      "type": "streamableHttp",
      "url": "https://oleander.dev/mcp",
      "headers": {
        "Authorization": "Bearer [OLEANDER-API-KEY]"
      }
    }
  }
}

​
Verify

Ask Codex to confirm it’s connected:
“Are you connected to oleander? Who am I authenticated as?”
Codex will call oleander_whoami and return your organization context.