io.github.leonardosepulvedat/mcp-google-analytics
NPM · MCP-GOOGLE-ANALYTICS · SCANNED SEP 20
GA4 MCP that reads AND writes: reports, funnels, audits, and server-side events. 26 tools.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security98
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- 44 of 130 dependencies flagged as unhealthy (1 deprecated). View diagnostics → Partial
Provenance & Transparency45
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 29 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability69
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 2891 tokens (~111/item across 26 items; 26 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage93
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 79% of tool parameters carry a description.Partial
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 9 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "ga_send_event" implies "send" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 26 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.leonardosepulvedat/mcp-google-analytics server?
io.github.leonardosepulvedat/mcp-google-analytics runs locally as an npm package, launched with npx -y mcp-google-analytics. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · mcp-google-analytics
claude mcp add leonardosepulvedat-mcp-google-analytics -- npx -y mcp-google-analytics
{
"mcpServers": {
"leonardosepulvedat-mcp-google-analytics": {
"command": "npx",
"args": [
"-y",
"mcp-google-analytics"
]
}
}
} {
"servers": {
"leonardosepulvedat-mcp-google-analytics": {
"command": "npx",
"args": [
"-y",
"mcp-google-analytics"
]
}
}
} codex mcp add leonardosepulvedat-mcp-google-analytics -- npx -y mcp-google-analytics
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"leonardosepulvedat-mcp-google-analytics": {
"type": "local",
"command": [
"npx",
"-y",
"mcp-google-analytics"
],
"enabled": true
}
}
} openclaw mcp add leonardosepulvedat-mcp-google-analytics --command npx --arg -y --arg mcp-google-analytics
mcp_servers:
leonardosepulvedat-mcp-google-analytics:
command: "npx"
args: ["-y", "mcp-google-analytics"] {
"McpServers": {
"leonardosepulvedat-mcp-google-analytics": {
"Transport": "stdio",
"Command": "npx",
"Arguments": [
"-y",
"mcp-google-analytics"
]
}
}
} assistant mcp add leonardosepulvedat-mcp-google-analytics -t stdio -c npx -a -y mcp-google-analytics
{
"mcpServers": {
"leonardosepulvedat-mcp-google-analytics": {
"command": "npx",
"args": [
"-y",
"mcp-google-analytics"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Sept 26 +1
- Stability: 0.97 → pass security
- 18 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.
- 7 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
- 5 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 47 to 50. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 15 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 20 Sept 2026 · Analysed npm/mcp-google-analytics@1.3.0
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Dependencies 130 packages
| Packages resolved | 130 |
|---|---|
| Deprecated | 1 |
| Stale | 43 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ga_batch_run_reports ~116
Run multiple reports in a single request. ⚠️ TOKEN OPTIMIZATION: Can return LARGE amounts of data. Limit to 2-5 reports per batch. Each report should have small limits.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
| requests | array | yes | Array of report requests (same format as ga_run_report) |
No output schema declared.
No examples provided.
ga_check_compatibility ~161
Check whether a combination of dimensions and metrics is valid for this property BEFORE running a report. Avoids wasted report requests and token-heavy error loops. Also lists which other fields remain compatible with the given combination.
| Name | Type | Req | Description |
|---|---|---|---|
| compatibilityFilter | string | – | Only return fields with this compatibility (recommended: COMPATIBLE) |
| dimensions | array | – | Dimensions to check (e.g., [{name: "city"}]) |
| metrics | array | – | Metrics to check (e.g., [{name: "activeUsers"}]) |
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_get_account_summaries ~44
Get a compact overview of all accessible GA accounts and their properties in a single call. The fastest way to discover account IDs, property IDs, and property names.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
ga_get_metadata ~103
Get available dimensions and metrics metadata for your GA4 property. ⚠️ TOKEN OPTIMIZATION: This returns ALL available dimensions and metrics. Response can be large (~500+ items). Use sparingly and cache results when possible.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_get_property ~77
Get details about a GA4 property (the configured one, or any accessible property via propertyId).
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_accounts ~30
List all Google Analytics accounts accessible to the service account. Use this to find account IDs for listing properties.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
ga_list_custom_dimensions ~92
List all custom dimensions defined for the configured GA4 property. Use this to discover custom dimension API names (e.g., "customEvent:plan_type") for reports.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_custom_metrics ~81
List all custom metrics defined for the configured GA4 property. Use this to discover custom metric API names for reports.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_data_streams ~79
List data streams for the configured GA4 property. Use this to find measurement IDs for Measurement Protocol.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_google_ads_links ~70
List Google Ads accounts linked to a GA4 property.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_key_events ~89
List the key events (conversions) configured for the GA4 property. Useful to know which event names count as conversions before building reports or sending events.
| Name | Type | Req | Description |
|---|---|---|---|
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_list_properties ~57
List Google Analytics properties. Optionally filter by account ID. Without an account ID, properties from all accessible accounts are aggregated.
| Name | Type | Req | Description |
|---|---|---|---|
| accountId | string | – | Optional account ID to filter properties (e.g., "123456789") |
No output schema declared.
No examples provided.
ga_run_funnel_report ~154
Run a funnel analysis report to track user progression through steps (Data API v1alpha). Each step matches an event: set 'eventName' per step (defaults to the step name). For advanced matching, pass a full 'filterExpression' instead.
| Name | Type | Req | Description |
|---|---|---|---|
| dateRanges | array | yes | – |
| funnelBreakdown | object | – | Optional dimension to break down funnel |
| funnelSteps | array | yes | Steps in the funnel |
| funnelVisualizationType | string | – | – |
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_run_pivot_report ~137
Run a pivot table report with row and column dimensions. ⚠️ TOKEN OPTIMIZATION: Pivot reports can be VERY large. Limit dimensions and use small date ranges. Recommended for analysis, not raw data extraction.
| Name | Type | Req | Description |
|---|---|---|---|
| dateRanges | array | yes | – |
| dimensions | array | – | – |
| metrics | array | yes | – |
| pivots | array | yes | Pivot specifications with fieldNames |
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_run_realtime_report ~156
Get real-time Google Analytics data (last 30 minutes). ⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10). Common dimensions: city, country, deviceCategory, unifiedScreenName Common metrics: activeUsers, screenPageViews, conversions
| Name | Type | Req | Description |
|---|---|---|---|
| dimensions | array | – | Dimensions to group by |
| limit | integer | – | Maximum number of rows (default: 10) |
| metrics | array | yes | Metrics to measure |
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_run_report ~258
Run a custom Google Analytics report with dimensions and metrics. ⚠️ TOKEN OPTIMIZATION: Use 'limit' to control result size (default: 10). This tool can consume significant tokens with large datasets. Common dimensions: date, city, country, deviceCategory, browser, pagePath, eventName Common metrics: activeUsers, sessions, screenPageViews, conversions, totalRevenue
| Name | Type | Req | Description |
|---|---|---|---|
| dateRanges | array | yes | Date ranges for the report |
| dimensionFilter | object | – | Dimension filter expression |
| dimensions | array | – | Dimensions to group by (e.g., [{name: "date"}]) |
| limit | integer | – | Maximum number of rows to return (default: 10) |
| metricFilter | object | – | Metric filter expression |
| metrics | array | yes | Metrics to measure (e.g., [{name: "activeUsers"}]) |
| offset | integer | – | Number of rows to skip (for pagination) |
| orderBys | array | – | Sorting specification |
| propertyId | string | – | GA4 property ID to query (overrides the default GA_PROPERTY_ID). Accepts "123456789" or "properties/123456789". Use ga_get_account_summaries to discover IDs. |
No output schema declared.
No examples provided.
ga_send_add_to_cart ~107
Send an add to cart event to Google Analytics. Ecommerce event for tracking when items are added to shopping cart.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| currency | string | yes | Currency code |
| items | array | yes | Items added to cart |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
| value | number | yes | Total value of items added |
No output schema declared.
No examples provided.
ga_send_begin_checkout ~112
Send a begin checkout event to Google Analytics. Ecommerce event for tracking when users start the checkout process.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| coupon | string | – | Coupon code applied |
| currency | string | yes | Currency code |
| items | array | yes | Items in checkout |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
| value | number | yes | Total value of cart |
No output schema declared.
No examples provided.
ga_send_event ~141
Send a custom event to Google Analytics via Measurement Protocol. Use this for tracking custom user actions, conversions, or any GA4 event. Events are processed asynchronously and appear in reports within minutes. Common events: click, form_submit, video_play, file_download, custom_conversion
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | Client ID (UUID format recommended). Auto-generated if not provided. |
| events | array | yes | Events to send (can send multiple in one request) |
| user_id | string | – | Optional User ID for cross-device tracking |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
No output schema declared.
No examples provided.
ga_send_login ~97
Send a login event to Google Analytics. Standard event for tracking user logins with authentication method.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| method | string | yes | Login method (e.g., "Google", "Email", "Facebook") |
| user_id | string | – | User ID (recommended for login events) |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
No output schema declared.
No examples provided.
ga_send_pageview ~124
Send a page view event to Google Analytics. Standard event for tracking page/screen views. Automatically uses 'page_view' event name.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | Client ID (auto-generated if not provided) |
| page_location | string | yes | Full URL of the page |
| page_referrer | string | – | Referrer URL |
| page_title | string | – | Page title |
| user_id | string | – | Optional User ID |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
No output schema declared.
No examples provided.
ga_send_purchase ~155
Send an ecommerce purchase event to Google Analytics. Standard event for tracking completed purchases with transaction details and items.
| Name | Type | Req | Description |
|---|---|---|---|
| affiliation | string | – | Store or affiliation |
| client_id | string | – | – |
| coupon | string | – | Coupon code used |
| currency | string | yes | Currency code (e.g., USD, EUR) |
| items | array | yes | Purchased items |
| shipping | number | – | Shipping cost |
| tax | number | – | Tax amount |
| transaction_id | string | yes | Unique transaction ID |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
| value | number | yes | Total purchase value |
No output schema declared.
No examples provided.
ga_send_refund ~148
Send a refund event to Google Analytics. Ecommerce event for full or partial refunds. Omit 'items' for a full refund; include them (with quantities) for a partial refund. Use the same transaction_id as the original purchase.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| currency | string | – | Currency code |
| items | array | – | Refunded items (only for partial refunds) |
| transaction_id | string | yes | Transaction ID of the original purchase |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
| value | number | – | Refunded amount |
No output schema declared.
No examples provided.
ga_send_signup ~92
Send a sign-up event to Google Analytics. Standard event for tracking new user registrations.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| method | string | yes | Sign-up method (e.g., "Google", "Email") |
| user_id | string | – | User ID for the new user |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
No output schema declared.
No examples provided.
ga_send_view_item ~121
Send a view item event to Google Analytics. Ecommerce event for tracking product/item detail views. Completes the standard funnel: view_item → add_to_cart → begin_checkout → purchase.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| currency | string | yes | Currency code |
| items | array | yes | Items viewed |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
| value | number | yes | Value of the viewed item(s) |
No output schema declared.
No examples provided.
ga_validate_event ~90
Validate an event before sending it to Google Analytics. Uses GA4's debug endpoint to check for errors without recording the event. Returns validation messages and errors if any.
| Name | Type | Req | Description |
|---|---|---|---|
| client_id | string | – | – |
| events | array | yes | – |
| user_id | string | – | – |
| user_properties | object | – | User properties (e.g., {subscription_tier: {value: "premium"}}) |
No output schema declared.
No examples provided.
What is the io.github.leonardosepulvedat/mcp-google-analytics server?
io.github.leonardosepulvedat/mcp-google-analytics is listed in the public MCP registry as io.github.leonardosepulvedat/mcp-google-analytics. GA4 MCP that reads AND writes: reports, funnels, audits, and server-side events. 26 tools. This page covers its npm package (mcp-google-analytics).
Is the io.github.leonardosepulvedat/mcp-google-analytics server safe to use?
io.github.leonardosepulvedat/mcp-google-analytics scores 81 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 20 September 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.leonardosepulvedat/mcp-google-analytics server expose?
io.github.leonardosepulvedat/mcp-google-analytics exposes 26 tools: ga_run_report, ga_run_realtime_report, ga_get_metadata, ga_list_accounts, ga_list_properties, and 21 more. Their descriptions and schemas cost roughly 2,891 tokens of context every time the server is loaded.
Is the io.github.leonardosepulvedat/mcp-google-analytics server still maintained?
io.github.leonardosepulvedat/mcp-google-analytics is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.leonardosepulvedat/mcp-google-analytics server under?
io.github.leonardosepulvedat/mcp-google-analytics declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.