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.

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.

  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.

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.

Was this helpful?

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

On this page