
Connect Amplitude MCP to Codex CLI so you can ask questions about your product data, such as funnels, cohorts, and experiments, directly from your terminal using OpenAI's Codex CLI agent. Setup uses OAuth and takes about two minutes. Use this when you want natural-language Amplitude access inside an OpenAI terminal-based AI workflow.

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

## How do I configure Amplitude MCP in Codex CLI?

For general MCP setup reference, refer to the [OpenAI Codex CLI 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. Follow the Amplitude OAuth authentication flow when prompted.

## How do I verify the connection works?

Ask Codex CLI: "What Amplitude projects can I access?" If you see a list of your projects, MCP is connected and authenticated.

## 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.
