Google Analytics Data API MCP Server

What is Google Analytics Data API MCP Server?

A Model Context Protocol (MCP) server for interacting with the Google Analytics Data API v1. It provides tools and resources for querying Google Analytics data, managing audiences, and accessing metadata.

How to use Google Analytics Data API MCP Server?

Configure the server by creating a .env file with GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, and DEFAULT_PROPERTY_ID. Install dependencies with npm install, then start the server using npm start or test with npm run inspect.

Key features of Google Analytics Data API MCP Server

• Run standard and pivot reports (single or batch)
• Create, list, update, and delete audiences
• Check compatibility between dimensions and metrics
• Access metadata about dimensions and metrics
• Browse dimensions and metrics by category
• Expose property, report, and audience resources via URIs

Use cases of Google Analytics Data API MCP Server

• Running custom reports on GA4 data with specified dimensions and metrics
• Creating and managing audience segments for marketing
• Batch-running multiple reports in a single request
• Exploring available dimensions, metrics, and their compatibility
• Automating audience lifecycle (create, read, update, delete) from tools like Claude

FAQ from Google Analytics Data API MCP Server

What are the prerequisites to run this server?

Node.js 14 or higher, a Google Analytics 4 property, and a Google Cloud service account with appropriate permissions.

How do I configure the server?

Create a .env file with three variables: GOOGLE_CLIENT_EMAIL, GOOGLE_PRIVATE_KEY, and DEFAULT_PROPERTY_ID. The property ID must use the format properties/123456789.

What tools does the server expose?

Eleven tools covering reporting (runReport, batchRunReports, runPivotReport, batchRunPivotReports), metadata (getMetadata, checkCompatibility), and audience management (createAudience, listAudiences, getAudience, deleteAudience, updateAudience).

What resources (URIs) are available?

Resources include ga://property/{propertyId}, ga://report/…, ga://metadata, ga://dimensions[/category], ga://metrics[/category], and ga://audiences/{propertyId}[/{audienceId}].

What is the license for this server?

The project is licensed under the MIT license.