How googleanalytics/google-analytics-mcp works
This is an experimental local MCP server that exposes Google Analytics account/property discovery and reporting tools to an MCP client. The workflow is: the client connects over stdio, the server delegates tool listing and calls to the coordinator, and the selected tool builds an Analytics API request, obtains a configured client, and returns serialized results. The README documents account/property details, Ads links, standard, funnel, custom-metadata, and realtime reports. Source excerpts also show annotations and conversion reporting. Some reporting-module internals were only partially sampled, so unverified links are omitted.
Main entry points: client.py Analytics API clients · coordinator.py Tool coordinator · metadata.py Custom metadata · core.py Core reports
Components 13
MCP entry
- stdio server
analytics_mcp/server.py - Tool coordinator
analytics_mcp/coordinator.py
Account administration
- Account and property tools
analytics_mcp/tools/admin/info.py
Analytics reporting
- Core reports
analytics_mcp/tools/reporting/core.py - Funnel reports
analytics_mcp/tools/reporting/funnel.py - Conversion reports
analytics_mcp/tools/reporting/conversions.py - Realtime reports
analytics_mcp/tools/reporting/realtime.py - Custom metadata
analytics_mcp/tools/reporting/metadata.py
API and serialization
- Analytics API clients
analytics_mcp/tools/client.py - Request and proto utilities
analytics_mcp/tools/utils.py
Other components
- MCP client
- Google Analytics Admin API
- Google Analytics Data API
Connections 28
- MCP client → stdio server: connects via stdio
analytics_mcp/server.py - stdio server → Tool coordinator: runs app
analytics_mcp/server.py - Tool coordinator → Account and property tools: registers and dispatches
analytics_mcp/coordinator.py - Tool coordinator → Core reports: registers and dispatches
analytics_mcp/coordinator.py - Tool coordinator → Funnel reports: registers and dispatches
analytics_mcp/coordinator.py - Tool coordinator → Conversion reports: registers and dispatches
analytics_mcp/coordinator.py - Tool coordinator → Realtime reports: registers and dispatches
analytics_mcp/coordinator.py - Tool coordinator → Custom metadata: registers and dispatches
analytics_mcp/coordinator.py - Account and property tools → Analytics API clients: creates API clients
analytics_mcp/tools/admin/info.py - Account and property tools → Request and proto utilities: formats requests and results
analytics_mcp/tools/admin/info.py - Core reports → Analytics API clients: creates data client
analytics_mcp/tools/reporting/core.py - Core reports → Request and proto utilities: formats request and result
analytics_mcp/tools/reporting/core.py - Core reports → Custom metadata: uses reporting hints
analytics_mcp/tools/reporting/core.py - Funnel reports → Analytics API clients: creates data client
analytics_mcp/tools/reporting/funnel.py - Conversion reports → Analytics API clients: creates data client
analytics_mcp/tools/reporting/conversions.py - Realtime reports → Analytics API clients: creates data client
analytics_mcp/tools/reporting/realtime.py - Realtime reports → Request and proto utilities: formats request and result
analytics_mcp/tools/reporting/realtime.py - Realtime reports → Custom metadata: uses reporting hints
analytics_mcp/tools/reporting/realtime.py - Custom metadata → Analytics API clients: creates data client
analytics_mcp/tools/reporting/metadata.py - Custom metadata → Request and proto utilities: formats property and results
analytics_mcp/tools/reporting/metadata.py - Analytics API clients → Google Analytics Admin API: creates Admin clients
analytics_mcp/tools/client.py - Analytics API clients → Google Analytics Data API: creates Data clients
analytics_mcp/tools/client.py - Account and property tools → Google Analytics Admin API: requests account data
analytics_mcp/tools/admin/info.py - Core reports → Google Analytics Data API: runs reports
analytics_mcp/tools/reporting/core.py - Funnel reports → Google Analytics Data API: runs funnel reports
analytics_mcp/tools/reporting/funnel.py - Conversion reports → Google Analytics Data API: runs conversion reports
analytics_mcp/tools/reporting/conversions.py - Realtime reports → Google Analytics Data API: runs realtime reports
analytics_mcp/tools/reporting/realtime.py - Custom metadata → Google Analytics Data API: retrieves metadata
analytics_mcp/tools/reporting/metadata.py