Which integrations are available for this server?

Allows querying Google Ads campaign, ad group, and keyword performance when a GA4 ↔ Google Ads link is configured. Provides SEO and paid reporting tools for Google Analytics 4, including organic/paid search performance, landing page analysis, channel and campaign breakdowns, conversions by source, realtime active users, and a flexible report runner.

How do I use Google Analytics MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google Analytics MCP Server show me organic search performance for the last month" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Google Analytics MCP

Local MCP server for Google Analytics 4. Wraps the GA4 Data API behind tools focused on SEO and Paid reporting.

Tools

Tool	Purpose
`ga4_organic_search_performance`	SEO: Organic Search sessions/users/engagement/conversions by landing page, source, country, or device
`ga4_paid_search_performance`	Paid: Paid Search sessions/conversions/cost/CPC by campaign, landing page, keyword, or source
`ga4_all_paid_performance`	Paid: all paid channels (Search + Social + Video + Display) with cost and ROAS
`ga4_google_ads_performance`	Paid: Google Ads campaign × ad group × keyword (requires GA4 ↔ Google Ads link)
`ga4_landing_page_performance`	Top landing pages by sessions/engagement/conversions (optional channel filter)
`ga4_channel_performance`	Default channel group rollup
`ga4_campaign_performance`	Campaign × source × medium breakdown
`ga4_conversions_by_source`	Conversions and key events by source/medium/channel
`ga4_realtime_active_users`	Active users in last 30 min
`ga4_run_report`	Flexible escape hatch — any dimensions + metrics

Setup

git clone https://github.com/ZLeventer/google-analytics-mcp-server.git
cd google-analytics-mcp-server
npm install
npm run build

Credentials

Copy .env.example to .env and fill in:

GA4_PROPERTY_ID — numeric property ID from GA4 Admin → Property Settings (e.g. 123456789). Not the Measurement ID (G-XXXXXXX).
GOOGLE_APPLICATION_CREDENTIALS — absolute path to the service account JSON key file.

Create the service account

Go to console.cloud.google.com → pick/create a project
APIs & Services → Library → enable Google Analytics Data API
IAM & Admin → Service Accounts → Create service account (name it ga4-mcp or similar)
On the created account → Keys → Add key → Create new key → JSON → download
Save the JSON as service-account.json in this directory (already in .gitignore)
In GA4 → Admin → Property Access Management, click + → paste the service account email (ga4-mcp@project-id.iam.gserviceaccount.com) → assign Viewer

The Google SDK auto-reads GOOGLE_APPLICATION_CREDENTIALS — no code changes needed.

Install into Claude Code

claude mcp add google-analytics \
  --env-file "/absolute/path/to/google-analytics-mcp-server/.env" \
  -- node "/absolute/path/to/google-analytics-mcp-server/dist/index.js"

Or add to ~/.claude.json manually:

{
  "mcpServers": {
    "google-analytics": {
      "command": "node",
      "args": ["/absolute/path/to/google-analytics-mcp-server/dist/index.js"],
      "env": {
        "GA4_PROPERTY_ID": "123456789",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/google-analytics-mcp-server/service-account.json"
      }
    }
  }
}

Restart Claude Code after install.

Date formats

All date args accept GA4 formats:

YYYY-MM-DD (e.g. 2026-04-01)
NdaysAgo (e.g. 28daysAgo, 90daysAgo)
yesterday, today

Defaults: 28daysAgo → yesterday.

Verification

After credentials are in place:

node -e '
  import("./dist/tools/reports.js").then(m =>
    m.channelPerformance({ start_date: "7daysAgo", end_date: "yesterday", limit: 10 })
  ).then(r => console.log(JSON.stringify(r, null, 2)))
'

If that returns rows, everything works. Expected errors:

GA4_PROPERTY_ID is not set — check .env
PERMISSION_DENIED — service account isn't granted Viewer on the property
403 Google Analytics Data API has not been used — enable the API in the GCP project

Roadmap

Admin API tools (list custom dimensions, conversion events, audiences) once needed
Search Console MCP as sibling server for rankings / impressions / CTR data (complements this one)
Pair with Demandbase MCP to join GA4 traffic with firmographics (account-level attribution)