Howzi MCP server for Google Analytics 4
Howzi lets an authorized user ask questions about their Google Analytics 4 (GA4) properties. Its remote MCP server provides historical and on-demand realtime reports, field discovery, usage information, and saved Howzi dashboards. Velyoo AG operates the service.
Howzi’s access to Google Analytics is read-only. Saving dashboard preferences changes the user’s Howzi configuration, never data in Google Analytics.
Connection
- MCP endpoint:
https://mcp.howzi.ai/mcp/ga4 - Transport: Streamable HTTP over HTTPS
- OAuth protected-resource metadata:
https://mcp.howzi.ai/.well-known/oauth-protected-resource/mcp/ga4 - OAuth authorization-server metadata:
https://mcp.howzi.ai/.well-known/oauth-authorization-server - Requested Howzi scope:
mcp.read - OAuth resource:
https://mcp.howzi.ai/mcp/ga4
The endpoint requires authorization. An unauthenticated request can return HTTP 401 with a WWW-Authenticate challenge pointing to the protected-resource metadata; that response is expected. Clients should use the published OAuth discovery metadata and complete the authorization-code flow with PKCE. Platform-specific client registration details and any credentials are supplied through that platform’s secure onboarding process, not on this public page.
The user signs in to Howzi with Google. Google sign-in and consent for read-only Google Analytics access are separate from the Howzi MCP authorization. The user then selects a GA4 property they are permitted to access. Each connected assistant receives its own authorization to Howzi.
Tools
The following table explains the tools’ purpose and effects. Download the machine-readable tool definitions (tools.json) for the supplied snapshot of tool names, input and output JSON Schemas, and annotations. This file was assembled from source and is not live tools/list evidence. A client should use the live MCP tool definitions when constructing calls.
| Tool | Main inputs | Result and effect |
|---|---|---|
get_account_status | None | Returns connection and selected-property status, with a setup link when action is needed. Read. |
list_dashboards | None | Lists the user’s configured property dashboards and default dashboard. Read. |
get_dashboard_configuration | Optional dashboard_id | Returns saved KPI preferences and a configuration link. Read. |
search_ga4_fields | Search text, field kind, optional dashboard, limit, custom-only flag, report type | Returns matching GA4 metric and dimension definitions, including restrictions where applicable. Read. |
check_ga4_compatibility | Base report and proposed field search | Returns compatible or blocked field additions for a report. Read. |
get_report_usage | None | Returns the account’s current report allowance, reset information, and paging limits. Read. |
run_ga4_report | operation_id, report definition, optional dashboard | Runs a historical GA4 report and returns its actual dates, values, status, and any paging or data-quality information. Read; successful retrievals count toward the account allowance. |
continue_ga4_report | operation_id, page_token | Retrieves the next page of an existing historical report when requested. Read; subject to report and paging limits. |
run_ga4_realtime_report | operation_id, report definition, optional dashboard | Returns a timestamped realtime snapshot. It is an on-demand query, not continuous monitoring. Read; successful retrievals count toward the account allowance. |
get_active_users | operation_id | Returns active users for the last seven complete days in the selected property’s timezone. Read; subject to the account allowance. |
get_dashboard | operation_id, period, optional dashboard | Returns the saved dashboard’s KPI results. Compatible MCP Apps hosts may also render an interactive card. Read; report retrieval limits apply. |
refresh_dashboard | operation_id, period, optional dashboard | Refreshes dashboard results without changing saved defaults. Read; report retrieval limits apply. |
configure_dashboard | Optional dashboard_id | Opens the Howzi dashboard editor in compatible hosts. Opening it does not save changes. |
preview_dashboard | Dashboard draft | Retrieves values for an authorized draft. Each successful preview uses one report retrieval. It does not save the draft. |
select_dashboard_property | editor_id, property_id | Selects an authorized property for the current configuration preview. It does not save a dashboard, but changes the temporary editor selection. |
save_dashboard_configuration | Complete dashboard draft | Write: explicitly saves validated KPI and property preferences in the user’s Howzi account. It does not modify GA4. |
report_dashboard_ui_event | Trace and instance identifiers, phase, source | Records a bounded diagnostic event for a compatible dashboard UI. It does not query or modify GA4. |
Some dashboard tools depend on a host that supports the relevant MCP Apps interface. A client without that interface should use the reporting tools and should not promise that an interactive card will render.
Permissions and user control
All GA4 report requests are restricted to properties available to the authenticated Howzi user. A caller-supplied property or dashboard ID does not grant access to another user’s property. Google Analytics permissions are read-only.
The dashboard Save operation is a Howzi settings write and should be disclosed and classified as such by a client. A user should initiate and approve a Save before the client calls save_dashboard_configuration. Report retrieval and dashboard configuration are separate actions.
Results, limits, and errors
Howzi Free currently supports one property dashboard, 3–5 saved KPIs, and 40 successful report retrievals per day. Howzi Pro supports multiple property dashboards, up to 9 saved KPIs, and 400 successful report retrievals per day. The current allowance and reset information are available from get_report_usage. Google Analytics and Howzi may also apply request and paging limits.
A report can return no data for the selected property, dates, dimensions, or filters. No data and unavailable values must not be presented as zero. Historical reports use completed dates in the property’s timezone. Realtime values are snapshots and may change. If a field combination is unsupported, the client should use the returned compatibility or error information to revise the request. If authorization expires, the user must reconnect. Clients should follow returned retry or reset guidance rather than repeatedly retrying a failed request.
Data handling and support
Howzi obtains authorized GA4 data to answer the user’s request and returns relevant results to the connected assistant. That assistant’s provider processes the content under its own terms and privacy policy. Howzi stores account connections and dashboard configuration; it does not offer a saved GA4 report-history feature. See the Howzi privacy policy and terms.
For connection or report problems, visit Howzi support. Do not send passwords, OAuth codes, tokens, or unredacted analytics data in a support request.