ga4-viz
Provides tools for running ad-hoc Google Analytics 4 queries with dimension/metric selection and visualizing results with interactive charts.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
GA4 Visualization MCP Server
An MCP server that enables interactive Google Analytics 4 visualizations inside Claude conversations.
Features
OAuth Authentication: Secure browser-based OAuth 2.0 PKCE flow
Ad-hoc Queries: Run custom GA4 queries with dimension/metric selection
Interactive Charts: Line, bar, pie charts and data tables using Chart.js
Dark Mode: Automatic theme adaptation
Related MCP server: mcp-marketing-analytics
Setup
Prerequisites
A Google Cloud project with the Google Analytics Data API enabled
OAuth 2.0 credentials configured for desktop application
A GA4 property ID
Google Cloud Configuration
Go to Google Cloud Console
Enable the Google Analytics Data API
Create OAuth 2.0 credentials:
Application type: Desktop app
Add
http://127.0.0.1:9876/callbackas an authorized redirect URI
Note your Client ID and Client Secret
Installation
# Clone and install dependencies
cd mcp-ga4-viz
pnpm install
# Build both packages
pnpm buildConfiguration
Create a .env file in the project root:
GA4_PROPERTY_ID=123456789
GOOGLE_CLIENT_ID=xxx.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=xxxClaude Desktop Configuration
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"ga4-viz": {
"command": "node",
"args": ["/path/to/mcp-ga4-viz/packages/server/dist/index.js"],
"env": {
"GA4_PROPERTY_ID": "123456789",
"GOOGLE_CLIENT_ID": "xxx.apps.googleusercontent.com",
"GOOGLE_CLIENT_SECRET": "xxx"
}
}
}
}Usage
Authentication
First, authenticate with Google Analytics:
"Authenticate with Google Analytics"This opens a browser window for OAuth consent. After authenticating, you can run queries.
Running Queries
Example queries:
"Show me sessions by country for the last 7 days as a bar chart"
"Get pageviews and users by date for the last 30 days as a line chart"
"Show top 10 landing pages by sessions"Available Tools
Tool | Description |
| Manage OAuth authentication (login/status/logout) |
| Run ad-hoc GA4 queries with visualization |
Common Dimensions
date,country,citydeviceCategory,browser,operatingSystemsessionSource,sessionMedium,sessionCampaignNamepagePath,pageTitle,landingPageeventName
Common Metrics
sessions,totalUsers,newUsers,activeUsersscreenPageViews,eventCount,conversionsengagedSessions,engagementRateaverageSessionDuration,bounceRate
Development
# Run server in development mode
cd packages/server
pnpm dev
# Run UI in development mode
cd packages/ui-chart
pnpm devArchitecture
mcp-ga4-viz/
├── packages/
│ ├── server/ # MCP server + GA4 API + OAuth
│ │ ├── src/
│ │ │ ├── auth/ # OAuth PKCE flow, token management
│ │ │ ├── ga4/ # GA4 Data API client
│ │ │ └── tools/ # MCP tool implementations
│ │ └── dist/ui/ # Built UI assets
│ └── ui-chart/ # Preact + Chart.js visualization
└── pnpm-workspace.yamlLicense
MIT
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
GA4, Google Ads and Search Console in Claude. Read-only OAuth, multi-account for agencies.
Connect Google Analytics to ChatGPT. Query GA4 data in plain English and get instant insights.
Read-only Google Ads, GA4 and Search Console data for Claude, with no Google Cloud setup.
Ask Claude about your Google Ads: campaign performance, wasted search terms, GAQL reports.
Related MCP Servers
- AlicenseAqualityBmaintenanceConnects Google Analytics 4 data to Claude, Cursor and other MCP clients, enabling natural language queries of website traffic, user behavior, and analytics data with access to 200+ GA4 dimensions and metrics.122,517 PyPI244MIT
- FlicenseAqualityDmaintenanceEnables natural language querying of Google Analytics 4, Google Search Console, Meta Ads, and Google Ads data through Claude.23-
- FlicenseAqualityDmaintenanceConnects Claude to Google Analytics 4 for querying website analytics via natural language, enabling traffic summaries, top pages, traffic sources, and user engagement.4-
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Google Analytics through Admin and Data APIs, allowing retrieval of account details, reports, and realtime data via natural language.Apache 2.0