Product
Google Analytics
Google Analytics admin and data APIs for GA4 properties, configuration and reports.
Install
ganalytics is one plugin in the google-services-mcps marketplace, and it runs one MCP server with the same name. Install it for Claude Code with the command below. For Codex, OpenCode or Antigravity, change --agent; the product id stays the same.
Install for Claude Code
npx google-services-mcps install --agent claude --plugin ganalyticsWhat it manages
The server carries 2 generated API bindings and 1 gateway APIs. Gateway APIs are reached through api_search, api_describe and api_call, which every product with gateway APIs lists.
| API | Version |
|---|---|
| analyticsadmin | v1beta |
| analyticsdata | v1beta |
| API | Version |
|---|---|
| analyticsadmin | v1alpha |
Tools
The plugin's server registers 83 tools: 44 reads, 28 writes, 10 destructive actions and 1 dynamic tools. A read never asks. A write is listed only when Allow write tools is on, and asks before it runs. A destructive action asks twice. A dynamic tool decides per call.
Every tool name starts with mcp__plugin_ganalytics_ganalytics__, so a call traces back to this product. The table lists the tools this server registers, with the safety class from the plugin's tool map.
| Tool | Class | What it does |
|---|---|---|
| account_remove | write | Remove a signed-in account |
| account_set_default | write | Set the default account |
| accounts_list | read | Signed-in accounts |
| api_call | dynamic | Call an API method |
| api_describe | read | Describe an API method |
| api_methods | read | ganalytics: API methods |
| api_search | read | Search API methods |
| auth_login | write | Sign in to Google |
| auth_setup_client | write | Save the Google OAuth client |
| auth_status | read | Sign-in status |
| ga_annotation_create | write | Create a Google Analytics annotation |
| ga_annotations_list | read | List Google Analytics annotations |
| ga_get_metadata | read | List a property's dimensions and metrics |
| ga_run_funnel_report | read | Run a Google Analytics funnel report |
| ga_run_realtime_report | read | Run a Google Analytics realtime report |
| ga_run_report | read | Run a Google Analytics report |
| gaa_get_data_sharing_settings | read | analyticsadmin.accounts.getDataSharingSettings |
| gaad_properties_access_report | read | analyticsadmin.properties.runAccessReport |
| gaad_props_retention_settings | read | analyticsadmin.properties.getDataRetentionSettings |
| gaadm_accounts_history_events | read | analyticsadmin.accounts.searchChangeHistoryEvents |
| gaadm_props_key_events_create | write | analyticsadmin.properties.keyEvents.create |
| gaadm_props_key_events_delete | destructive | analyticsadmin.properties.keyEvents.delete |
| gaadmi_props_key_events_patch | write | analyticsadmin.properties.keyEvents.patch |
| gaadmi_streams_secrets_create | write | analyticsadmin.properties.dataStreams.measurementProtocolSecrets.create |
| gaadmi_streams_secrets_delete | destructive | analyticsadmin.properties.dataStreams.measurementProtocolSecrets.delete |
| gaadmin_accounts_delete | destructive | analyticsadmin.accounts.delete |
| gaadmin_accounts_get | read | analyticsadmin.accounts.get |
| gaadmin_accounts_list | read | analyticsadmin.accounts.list |
| gaadmin_accounts_patch | write | analyticsadmin.accounts.patch |
| gaadmin_acct_summaries_list | read | analyticsadmin.accountSummaries.list |
| gaadmin_pro_goo_ads_link_crea | write | analyticsadmin.properties.googleAdsLinks.create |
| gaadmin_pro_goo_ads_link_dele | destructive | analyticsadmin.properties.googleAdsLinks.delete |
| gaadmin_pro_goo_ads_link_list | read | analyticsadmin.properties.googleAdsLinks.list |
| gaadmin_pro_upd_dat_rete_sett | write | analyticsadmin.properties.updateDataRetentionSettings |
| gaadmin_properties_create | write | analyticsadmin.properties.create |
| gaadmin_properties_data_coll | write | analyticsadmin.properties.acknowledgeUserDataCollection |
| gaadmin_properties_delete | destructive | analyticsadmin.properties.delete |
| gaadmin_properties_get | read | analyticsadmin.properties.get |
| gaadmin_properties_list | read | analyticsadmin.properties.list |
| gaadmin_properties_patch | write | analyticsadmin.properties.patch |
| gaadmin_props_conv_events_get | read | analyticsadmin.properties.conversionEvents.get |
| gaadmin_props_custom_dims_get | read | analyticsadmin.properties.customDimensions.get |
| gaadmin_props_dims_archive | destructive | analyticsadmin.properties.customDimensions.archive |
| gaadmin_props_dims_create | write | analyticsadmin.properties.customDimensions.create |
| gaadmin_props_dims_list | read | analyticsadmin.properties.customDimensions.list |
| gaadmin_props_dims_patch | write | analyticsadmin.properties.customDimensions.patch |
| gaadmin_props_events_create | write | analyticsadmin.properties.conversionEvents.create |
| gaadmin_props_events_delete | destructive | analyticsadmin.properties.conversionEvents.delete |
| gaadmin_props_events_list | read | analyticsadmin.properties.conversionEvents.list |
| gaadmin_props_events_patch | write | analyticsadmin.properties.conversionEvents.patch |
| gaadmin_props_key_events_get | read | analyticsadmin.properties.keyEvents.get |
| gaadmin_props_key_events_list | read | analyticsadmin.properties.keyEvents.list |
| gaadmin_props_links_create | write | analyticsadmin.properties.firebaseLinks.create |
| gaadmin_props_links_delete | destructive | analyticsadmin.properties.firebaseLinks.delete |
| gaadmin_props_links_list | read | analyticsadmin.properties.firebaseLinks.list |
| gaadmin_props_links_patch | write | analyticsadmin.properties.googleAdsLinks.patch |
| gaadmin_props_metrics_archive | destructive | analyticsadmin.properties.customMetrics.archive |
| gaadmin_props_metrics_create | write | analyticsadmin.properties.customMetrics.create |
| gaadmin_props_metrics_get | read | analyticsadmin.properties.customMetrics.get |
| gaadmin_props_metrics_list | read | analyticsadmin.properties.customMetrics.list |
| gaadmin_props_metrics_patch | write | analyticsadmin.properties.customMetrics.patch |
| gaadmin_props_streams_create | write | analyticsadmin.properties.dataStreams.create |
| gaadmin_props_streams_delete | destructive | analyticsadmin.properties.dataStreams.delete |
| gaadmin_props_streams_get | read | analyticsadmin.properties.dataStreams.get |
| gaadmin_props_streams_list | read | analyticsadmin.properties.dataStreams.list |
| gaadmin_props_streams_patch | write | analyticsadmin.properties.dataStreams.patch |
| gaadmin_provision_acct_ticket | write | analyticsadmin.accounts.provisionAccountTicket |
| gaadmin_run_access_report | read | analyticsadmin.accounts.runAccessReport |
| gaadmin_streams_secrets_get | write | analyticsadmin.properties.dataStreams.measurementProtocolSecrets.get |
| gaadmin_streams_secrets_list | read | analyticsadmin.properties.dataStreams.measurementProtocolSecrets.list |
| gaadmin_streams_secrets_patch | write | analyticsadmin.properties.dataStreams.measurementProtocolSecrets.patch |
| gadat_batch_run_pivot_reports | read | analyticsdata.properties.batchRunPivotReports |
| gadata_batch_run_reports | read | analyticsdata.properties.batchRunReports |
| gadata_check_compatibility | read | analyticsdata.properties.checkCompatibility |
| gadata_properties_run_report | read | analyticsdata.properties.runReport |
| gadata_props_aud_exports_get | read | analyticsdata.properties.audienceExports.get |
| gadata_props_aud_exports_list | read | analyticsdata.properties.audienceExports.list |
| gadata_props_exports_create | write | analyticsdata.properties.audienceExports.create |
| gadata_props_exports_query | read | analyticsdata.properties.audienceExports.query |
| gadata_props_get_meta | read | analyticsdata.properties.getMetadata |
| gadata_props_run_pivot_report | read | analyticsdata.properties.runPivotReport |
| gadata_run_realtime_report | read | analyticsdata.properties.runRealtimeReport |
| health | read | Server health |
The plugin option toolset can list fewer tools. google lists 9 tools that do the same jobs as Google's official MCP server for this product; curated lists the hand-written and gateway tools; all is the default.
Sign-in
ganalytics belongs to the business login group. Log in once for the group: create a Desktop OAuth client in a Google Cloud project, save its file with npx google-services-mcps setup-client, then run npx google-services-mcps login business.
The plugin's scope file lists 3 OAuth scopes for 1 APIs. A login asks only for the scopes of its profile: readonly (the default), readwrite, full, or an exact list.
| API | Scope |
|---|---|
| ganalytics | https://www.googleapis.com/auth/analytics |
| ganalytics | https://www.googleapis.com/auth/analytics.edit |
| ganalytics | https://www.googleapis.com/auth/analytics.readonly |
Plugin details
- Plugin
- ganalytics
- MCP server
- ganalytics
- Display name
- Google Analytics
- Version
- 2.17.0
- Marketplace
- google-services-mcps
- Login group
- business
- Marketplace category
- marketing
- Plugin options
- allow_writes, confirmation, token_dir, toolset
- Server kind
- curated+discovery