ga4-mcp-server

Overview

This is a production-ready MCP server that provides access to Google Analytics 4 data through both Model Context Protocol and REST endpoints. It includes five useful tools: getUrlAnalytics, getUrlEngagement, getUrlSourceTraffic, getUrlConversions, and getUrlPageViews. The server features proper authentication using service accounts, structured response formats with time-based breakdowns, and comprehensive error handling. Built with TypeScript using the official @modelcontextprotocol/sdk, it demonstrates best practices with Jest tests, debug logging, and smoke scripts for both MCP and REST interfaces.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• getUrlAnalytics({ url: string, timeframe?: string, startDate?: string, endDate?: string, trafficSourceLimit?: number }) => AnalyticsResponse

  Get comprehensive analytics for a URL including engagement, traffic sources, and conversions

  Try:Show me analytics for the /about page for this monthTry:What are the traffic sources for our homepage?Try:Get analytics for /products from January 1 to January 31
• getUrlEngagement({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get engagement metrics for a URL such as average session duration and bounce rate

  Try:What's the engagement rate for our blog posts?Try:Show me bounce rate for the /contact pageTry:Get engagement metrics for the /pricing page from last week
• getUrlSourceTraffic({ url: string, timeframe?: string, startDate?: string, endDate?: string, limit?: number }) => AnalyticsResponse

  Get traffic source data for a URL showing how users are finding the page

  Try:Where is our traffic coming from for the /sign-up page?Try:Show me the top 5 traffic sources for our homepageTry:What are the main traffic sources for /blog posts?
• getUrlConversions({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get conversion events and metrics for a URL

  Try:Show me conversion data for our checkout pageTry:What conversion events happened on /subscribe?Try:Get conversion metrics for the /pricing page
• getUrlPageViews({ url: string, timeframe?: string, startDate?: string, endDate?: string }) => AnalyticsResponse

  Get page view statistics for a URL

  Try:How many page views did the /about page get last week?Try:Show me page view trends for our blogTry:Compare page views for /products and /services

Comparable tools

Installation

pnpm install

GA_PROPERTY_ID=your_ga4_property_id
GOOGLE_APPLICATION_CREDENTIALS=path/to/your/credentials.json
PORT=3001 # optional, defaults to 3001

pnpm dev

{
  "mcpServers": {
    "ga4": {
      "command": "node",
      "args": ["dist/index.js"],
      "env": {
        "GA_PROPERTY_ID": "your_ga4_property_id",
        "GOOGLE_APPLICATION_CREDENTIALS": "path/to/your/credentials.json"
      }
    }
  }
}

FAQ

What authentication method is required for this server?

The server requires Google service account authentication. You need to provide a service account JSON file and set the GOOGLE_APPLICATION_CREDENTIALS environment variable.

Can I use this server with my existing Google Analytics 4 property?

Yes, as long as your service account has appropriate permissions to access the GA4 property data. You'll need to configure it in the Google Cloud Console.

Compare ga4-mcp-server with