Claude용 Google Analytics MCP

This repo contains the source code for running a local MCP server that interacts with APIs for Google Analytics. Join the discussion and ask questions in the 🤖-analytics-mcp channel on Discord. The server uses the Google Analytics Admin API and Google Analytics Data API to provide several Tools for use with LLMs. get_account_summaries : Retrieves information about the user's Google Analytics accounts and properties.get_property_details : Returns details about a property.list_google_ads_links : Returns a list of links to Google Ads accounts for a property. run_report : Runs a Google Analytics report using the Data API.get_custom_dimensions_and_metrics : Retrieves the custom dimensions and metrics for a specific property. run_realtime_report : Runs a Google Analytics realtime report using the Data API. ✨ Watch the Google Analytics MCP Setup Tutorial on YouTube for a step-by-step walkthrough of these instructions. Setup involves the following steps: - Configure Python. - Configure credentials for Google Analytics. - Configure Gemini. Follow the instructions to enable the following APIs in your Google Cloud project: Configure your Application Default Credentials (ADC). Make sure the credentials are for a user with access to your Google Analytics accounts or properties. Credentials must include the Google Analytics read-only scope: https://www.googleapis.com/auth/analytics.readonly Check out Manage OAuth Clients for how to create an OAuth client. Here are some sample gcloud commands you might find useful: - Set up ADC using user credentials and an OAuth desktop or web client after downloading the client JSON to YOUR_CLIENT_JSON_FILE .gcloud auth application-default login \ --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \ --client-id-file=YOUR_CLIENT_JSON_FILE - Set up ADC using service account impersonation. gcloud auth application-default login \ --impersonate-service-account=SERVICE_ACCOUNT_EMAIL \ --scopes=https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform When the gcloud auth application-default command completes, copy the PATH_TO_CREDENTIALS_JSON file location printed to the console in the following message. You'll need this for the next step! Credentials saved to file: [PATH_TO_CREDENTIALS_JSON] - Install Gemini CLI or Gemini Code Assist. - Create or edit the file at ~/.gemini/settings.json , adding your server to themcpServers list.Replace PATH_TO_CREDENTIALS_JSON with the path you copied in the previous step.We also recommend that you add a GOOGLE_CLOUD_PROJECT attribute to theenv object. ReplaceYOUR_PROJECT_ID in the following example with the project ID of your Google Cloud project.{ "mcpServers": { "analytics-mcp": { "command": "pipx", "args": [ "run", "analytics-mcp" ], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON", "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID" } } } } Launch Gemini Code Assist or Gemini CLI and type /mcp . You should see analytics-mcp listed in the results. Here are some sample prompts to get you started: - Ask what the server can do: what can the analytics-mcp server do? - Ask about a Google Analytics property Give me details about my Google Analytics property with 'xyz' in the name - Prompt for analysis: what are the most popular events in my Google Analytics property in the last 180 days? - Ask about signed-in users: were most of my users in the last 6 months logged in? - Ask about property configuration: what are the custom dimensions and custom metrics in my property? Contributions welcome! See the Contributing Guide.