HOWZI DOCUMENTATION

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

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.

ToolMain inputsResult and effect
get_account_statusNoneReturns connection and selected-property status, with a setup link when action is needed. Read.
list_dashboardsNoneLists the user’s configured property dashboards and default dashboard. Read.
get_dashboard_configurationOptional dashboard_idReturns saved KPI preferences and a configuration link. Read.
search_ga4_fieldsSearch text, field kind, optional dashboard, limit, custom-only flag, report typeReturns matching GA4 metric and dimension definitions, including restrictions where applicable. Read.
check_ga4_compatibilityBase report and proposed field searchReturns compatible or blocked field additions for a report. Read.
get_report_usageNoneReturns the account’s current report allowance, reset information, and paging limits. Read.
run_ga4_reportoperation_id, report definition, optional dashboardRuns 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_reportoperation_id, page_tokenRetrieves the next page of an existing historical report when requested. Read; subject to report and paging limits.
run_ga4_realtime_reportoperation_id, report definition, optional dashboardReturns a timestamped realtime snapshot. It is an on-demand query, not continuous monitoring. Read; successful retrievals count toward the account allowance.
get_active_usersoperation_idReturns active users for the last seven complete days in the selected property’s timezone. Read; subject to the account allowance.
get_dashboardoperation_id, period, optional dashboardReturns the saved dashboard’s KPI results. Compatible MCP Apps hosts may also render an interactive card. Read; report retrieval limits apply.
refresh_dashboardoperation_id, period, optional dashboardRefreshes dashboard results without changing saved defaults. Read; report retrieval limits apply.
configure_dashboardOptional dashboard_idOpens the Howzi dashboard editor in compatible hosts. Opening it does not save changes.
preview_dashboardDashboard draftRetrieves values for an authorized draft. Each successful preview uses one report retrieval. It does not save the draft.
select_dashboard_propertyeditor_id, property_idSelects an authorized property for the current configuration preview. It does not save a dashboard, but changes the temporary editor selection.
save_dashboard_configurationComplete dashboard draftWrite: explicitly saves validated KPI and property preferences in the user’s Howzi account. It does not modify GA4.
report_dashboard_ui_eventTrace and instance identifiers, phase, sourceRecords 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.