Google Analytics Data API MCP Server

What is Google Analytics Data API MCP Server?

The Google Analytics Data API MCP Server provides a Model Context Protocol (MCP) interface to access the Google Analytics Data API. It is aimed at developers who want to query GA4 reports, real-time data, and property metadata using AI assistants like Claude.

How to use Google Analytics Data API MCP Server?

Clone the repository, run npm install and npm build, then set the environment variables GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, and GA_PROPERTY_ID. Start the server with npm start or ./run-server.sh, or configure it as an MCP server in Claude Desktop by adding the command and environment variables to the configuration file.

Key features of Google Analytics Data API MCP Server

• get_report tool: fetch reports with date range, metrics, and dimensions
• get_realtime_data tool: retrieve real-time analytics data
• ga4://property/{propertyId}/metadata resource: access property metadata

Use cases of Google Analytics Data API MCP Server

• Query historical user engagement metrics over custom date ranges
• Monitor live audience activity broken down by device category
• Explore available metrics and dimensions for a GA4 property

FAQ from Google Analytics Data API MCP Server

What tools does the server provide?

Two tools: get_report for historical reports and get_realtime_data for live data.

What are the prerequisites?

A Google Cloud project with the Analytics Data API enabled, a service account with JSON credentials, and access to a GA4 property.

How do I configure environment variables?

Set GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, and GA_PROPERTY_ID in your shell or Claude Desktop config.

How do I use this server with Claude Desktop?

Add an mcpServers entry with command: "node", args pointing to the build index, and the required environment variables.

What does the resource ga4://property/{propertyId}/metadata do?

It provides access to the property's metadata, listing available metrics and dimensions.