On this page

How to connect Amplitude MCP to Gemini CLI

Connect Amplitude MCP to Gemini CLI so you can ask questions about your product data, such as funnels, cohorts, and experiments, directly from your terminal. Setup takes about two minutes and uses OAuth for authentication. Use this when you want natural-language Amplitude access inside a Google AI terminal workflow.

You need an active Amplitude account with project access, Gemini CLI installed, and an authenticated Gemini session.

How do I configure Amplitude MCP in Gemini CLI?

For general MCP setup reference, refer to the Gemini CLI MCP documentation.
  1. Ensure you're authenticated with Gemini CLI.

  2. Add the Amplitude MCP server to your ~/.gemini/settings.json:

    json
    {
      "selectedAuthType": "oauth-personal",
      "mcpServers": {
        "amplitude": {
          "httpUrl": "https://mcp.amplitude.com/mcp"
        }
      }
    }
    

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

  3. Restart the Gemini CLI MCP server and authenticate with Amplitude:

    shell
    gemini/mcp auth amplitude
    

How do I verify the connection works?

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

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

Replace https://mcp.amplitude.com/mcp with https://mcp.eu.amplitude.com/mcp in ~/.gemini/settings.json, then re-authenticate:

shell
gemini/mcp auth amplitude

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.

Does Gemini CLI support both read and write Amplitude operations?

Yes. All Amplitude MCP tools, including creation and editing of charts, dashboards, cohorts, and experiments, work through the Gemini CLI integration, subject to your Amplitude account permissions.

Was this helpful?