---
title: Connect Amplitude MCP to Codex
description: "Connect Amplitude MCP to OpenAI Codex to query charts, dashboards, experiments, and cohorts in plain English from your terminal or IDE. Setup uses OAuth and takes about two minutes."
product: general
lang: en
last_updated: 2026-11-04
token_estimate: 641
---
# Connect Amplitude MCP to Codex

Connect Amplitude MCP to OpenAI Codex so you can ask questions about your product data, such as funnels, cohorts, and experiments, directly from the Codex CLI or the Codex IDE extension. Setup uses OAuth and takes about two minutes. Use this when you want natural-language Amplitude access inside an OpenAI coding agent workflow. To compare Codex with Cursor and Claude Code, or for region and authentication details, go to [Connect Amplitude MCP to your AI client](https://amplitude.com/docs/amplitude-ai/amplitude-mcp#connect-amplitude-mcp-to-your-ai-client).

> For AI agents: a documentation index is available at [/docs/llms.txt](/docs/llms.txt). Append `.md` to any page URL for markdown, or send `Accept: text/markdown`.

You need an active Amplitude account with project access and the Codex CLI installed and authenticated.

## How do I configure Amplitude MCP in Codex?

For general MCP setup reference, refer to the [OpenAI Codex MCP documentation](https://developers.openai.com/codex/mcp/).

1. Add the Amplitude MCP server:

   ```shell
   codex mcp add amplitude --url https://mcp.amplitude.com/mcp
   ```

   EU customers should use `https://mcp.eu.amplitude.com/mcp` instead.
2. Complete the OAuth flow that opens in your browser.

The command writes this block to `~/.codex/config.toml`. The Codex CLI and the Codex IDE extension both read this file. You can also add the block to the file yourself:

```toml
[mcp_servers.amplitude]
url = "https://mcp.amplitude.com/mcp"
```

If you edit the file directly or your sign-in expires, run this command to complete the OAuth flow:

```shell
codex mcp login amplitude
```

## How do I verify the connection works?

Adding the server only tells Codex where it is. Check both of these to confirm the connection:

1. Run `codex mcp list` to confirm the configuration includes Amplitude. This command doesn't call the server.
2. Ask Codex: "What Amplitude projects can I access?" A list of your projects confirms the connection.

## Frequently asked questions

### How do I switch Amplitude MCP from the US server to EU residency?

Run the add command again with the EU URL to overwrite the existing entry:

```shell
codex mcp add amplitude --url https://mcp.eu.amplitude.com/mcp
```

Re-authenticate when prompted.

### What permissions does the Amplitude MCP server have?

The MCP server inherits the Amplitude permissions of the user who authenticates. You can only read or modify projects you already have access to in Amplitude. Amplitude grants no additional access.

