Google Analytics MCP: a free GA4 connector for Claude

Lets Claude read all of your Google Analytics 4 data: accounts, properties, traffic, conversions, revenue, funnels and realtime activity. It's free and open source (MIT).

• Free: it talks straight to Google's own Analytics APIs, which cost nothing. No subscription, no third-party service, no server to host.

• Private: your data only travels between your computer and Google. Your sign-in token stays on your machine.

• Read-only: it can't change anything in Google Analytics.

• Nothing extra to install: it needs only Node.js 18 or newer.

• Works with Claude Code, Claude Desktop, Cursor and any other MCP client.

Quick start

1. Install

Claude Code: inside Claude Code, run:

/plugin marketplace add mmoasa00/google-analytics-mcp
/plugin install google-analytics@google-analytics-mcp

Then restart Claude Code.

Claude Desktop, Cursor and other MCP clients: add this to the app's MCP config. In Claude Desktop that's Settings → Developer → Edit Config:

{
  "mcpServers": {
    "google-analytics": {
      "command": "npx",
      "args": ["-y", "github:mmoasa00/google-analytics-mcp"]
    }
  }
}

2. Set it up: Claude walks you through it

Ask Claude:

"Help me set up Google Analytics"

In Claude Code you can also type /ga-setup. Claude checks what's already done and gives you one step at a time: which link to open, exactly what to click, and what you should see. It checks each step before moving on, and helps if something looks different or shows an error.

Prefer reading? The full step-by-step checklist is in docs/SETUP-GUIDE.md.

3. Ask questions

• "Which GA properties do I have?"

• "How did traffic change this month vs last month, by channel?"

• "Top 20 landing pages by conversions in the last 90 days"

• "How many people are on the site right now, and from where?"

• /ga-report mysite.com last 30 days

Related MCP server: GA4 MCP Server

The OAuth client, in short

Google requires every app that signs people in to have an "OAuth client". It's free. One person creates it once, and the whole team uses the same file. The step-by-step guide covers each click. In summary:

1. Create a Google Cloud project.

2. Enable the Analytics Admin API and the Analytics Data API.

3. Google Auth Platform → Get started. Choose Internal if everyone is on one Google Workspace domain; otherwise choose External.

4. External only: Audience → Publish app. Or add test users, but then sign-ins expire every 7 days.

5. Clients → Create client → Desktop app → Download JSON straight away. Google shows the secret only once.

6. Say "connect my Google Analytics". The file is found in your Downloads folder automatically. You can also connect from a terminal:

   npx -y github:mmoasa00/google-analytics-mcp login

Sharing with your team

Pick one:

• Send the JSON file to teammates privately. They save it to their Downloads folder and say "connect my Google Analytics".

• Fork this repo and save the file as plugins/google-analytics/oauth-client.json in your fork (see oauth-client.example.json). Teammates install from your fork and only have to click "Sign in". Google doesn't treat desktop-app client secrets as confidential, but a private fork is still the tidier choice.

Each person signs in with their own Google account and sees only the GA properties they already have access to.

Other ways to authenticate

The server checks for credentials in this order:

Environment variables (all optional)

Tools

Claude Code also gets a google-analytics skill, plus the /ga-setup, /ga-connect and /ga-report commands.

Limits

• GA4 only. Google has shut down Universal Analytics data.

• Google's free API quotas apply per property. They're generous for normal use.

• Results are subject to GA's own sampling and thresholding. When that happens, the server includes it in the response.

Troubleshooting

License

MIT. Free forever.