Connect Amplitude MCP to Claude Code

Connect Amplitude MCP to Claude Code so you can ask questions about your product data, such as funnels, cohorts, and experiments, directly from your terminal. Setup uses OAuth and takes about two minutes, with no API keys to manage. Use this when you want to analyze Amplitude data without leaving your development environment.

Use Claude Code if you prefer terminal-based AI workflows. If you want browser-based chat instead, use the Claude connector for claude.ai. To compare Claude Code with Cursor and Codex, 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 Claude Code installed.

How do I install Amplitude MCP in Claude Code?

For general MCP setup reference, refer to the Claude Code MCP documentation.

  1. Add the MCP server for your user account:

    shell
    claude mcp add --transport http --scope user Amplitude https://mcp.amplitude.com/mcp
    

    EU customers should use https://mcp.eu.amplitude.com/mcp instead.

  2. Start Claude Code:

    shell
    claude
    
  3. Open the MCP menu:

    shell
    /mcp
    
  4. Select Amplitude and follow the OAuth authentication flow.

How do I share the server with my team?

Use --scope project instead of --scope user. Claude Code writes a .mcp.json file at the repository root that you can commit:

json
{
  "mcpServers": {
    "Amplitude": {
      "type": "http",
      "url": "https://mcp.amplitude.com/mcp"
    }
  }
}

Each person who opens the repository approves the server the first time Claude Code loads it, then completes OAuth through /mcp with their own Amplitude account.

How do I verify the connection works?

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

  1. Run /mcp in a session or claude mcp list in your shell. Amplitude shows as connected. A status that says the server needs authentication or approval means it isn't connected yet.
  2. Ask Claude Code: "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?

Remove the existing entry, then add it again with the EU URL:

shell
claude mcp remove --scope user Amplitude
claude mcp add --transport http --scope user Amplitude https://mcp.eu.amplitude.com/mcp

Run /mcp and re-authenticate.

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.

What does the flag do?

--scope user registers the server for your user account, so it's available in every Claude Code session. --scope project writes it to a shared .mcp.json file in the repository. --scope local, the default, adds it only for you in the current project directory.

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