Skip to main content
Glama

MCP for Google Datastudio by Max Omen

An MCP server that lets AI agents (Claude Code, Codex and any other MCP client) build, edit, style and maintain Google Datastudio reports and datasources end to end — the way a person does it in the editor, with every change previewed, conflict-checked, journalled and read back.

License: free for personal and noncommercial use under the PolyForm Noncommercial License 1.0.0. Any commercial use — including use at or for a company — needs a commercial license. See License and permitted use.


Why

Datastudio has no public editing API for report content. Agents can describe a dashboard, but someone still clicks it together. This MCP drives the Datastudio editor itself, in a dedicated Chrome profile on your machine, through the editor's own services:

  • Everything the editor does: pages, navigation, every chart type and preset, every property-panel setting (~7,600 of them), filters and controls, blends, calculated fields, parameters, themes, publishing and revision history.

  • Safe by construction: writes default to a dry run; each one carries the fingerprint of what you read, so a concurrent edit is rejected instead of overwritten; every write is journalled with its before-state and verified by reading it back. Most writes can be undone with operation_restore.

  • Your data stays local: the MCP runs on your computer. Google cookies and tokens never leave the browser profile; nothing is sent to any third-party server.

Related MCP server: google-marketing

How it works

MCP client (Claude Code, Codex, …)
        │  stdio
        ▼
datastudio-mcp  ── Playwright / CDP ──►  Chrome (dedicated profile, headless)
                                              │  your Google session
                                              ▼
                                      datastudio.google.com editor
  • A dedicated Chrome profile (~/.datastudio-mcp/profile) holds your Google sign-in. Chrome runs headless; a window opens only when Google asks you to sign in.

  • Report edits go through the editor's native model and services, so they produce exactly what the editor would save.

  • Chrome closes itself after 10 minutes without a tool call and starts again on the next one; the sign-in is kept.

Requirements

  • Google Chrome. Developed and tested on macOS; on Linux set DATASTUDIO_CHROME_BINARY to your Chrome executable (untested). Windows is not supported yet.

  • uv (it brings Python 3.12 itself).

  • A Google account with access to the reports you want to edit.

Install

Claude Code

claude mcp add datastudio --scope user -- \
  uvx --refresh --from git+https://github.com/maxokhrimenko/datastudio-mcp datastudio-mcp

Codex

codex mcp add datastudio -- \
  uvx --refresh --from git+https://github.com/maxokhrimenko/datastudio-mcp datastudio-mcp

uvx --refresh picks up the latest version every time the client starts the server. Restart the client session (in Claude Code: /mcp) after installing.

The repository ships a skill that teaches agents the workflow (read → dry run → apply → verify) and the tool map. Install it from a clone:

git clone https://github.com/maxokhrimenko/datastudio-mcp.git
cd datastudio-mcp
scripts/install-skill.sh   # links skills/datastudio-mcp into ~/.claude/skills and ~/.agents/skills

From source

git clone https://github.com/maxokhrimenko/datastudio-mcp.git
cd datastudio-mcp
uv sync --frozen
claude mcp add datastudio --scope user -- "$PWD/.venv/bin/datastudio-mcp"

First run

Ask your agent to open a report:

Open https://datastudio.google.com/reporting/<report-id> and list its pages.

The first report_open starts Chrome. If Google wants a sign-in, a Chrome window appears: sign in there once and ask the agent to continue. The session is stored in the MCP's own profile — signing in to your everyday Chrome does not count.

What you can do

Area

Tools

Reports and pages

report_open, report_inspect, report_audit, pages_create, pages_delete, page_duplicate, pages_import, navigation_patch, report_rename, page_get, page_screenshot, page_insert_space

Components

components_create, components_fields, components_switch_type, components_geometry, components_arrange, components_layers, components_duplicate, components_copy_to_page, components_delete, groups_*, image_upload_set

Every panel setting

settings_describe, settings_set, settings_set_batch, native_catalog, theme_from_image, report_theme_copy, dimension_value_colors_set

Data

datasources_list, datasource_get, bigquery_browse, datasource_create_bigquery, datasource_add_to_report, calculated fields, field metadata, parameters, credentials, datasource_sharing_get / _set

Blends

blend_create, blend_get, blends_joins, blends_input_filters, blends_rename, blends_delete

Filters and controls

filters_*, components_filters, page_filters, report_filters, page_filter_inheritance, control_*

Publishing and history

report_publishing, report_publish, revisions_list, revision_restore, report_links, report_pdf, image_export

Recovery

operation_get, operation_restore, bundle_contracts

109 tools in total. The full editor coverage, item by item, is in docs/inventory/ui-inventory.md.

Every write follows the same contract

  1. Read the entity and take its fingerprint.

  2. Preview: writes default to dry_run=true and return the exact planned change.

  3. Apply with dry_run=false and the same fingerprint. VERSION_CONFLICT means something changed since your read.

  4. Only verified (or unchanged) is success. Writes land in the report draft; viewers see them after report_publish when the report uses manual publishing.

Not done by the MCP

Some actions stay with people by design: sharing reports, changing or removing existing datasource access, scheduled email delivery, creating, copying or deleting reports, creating datasources from connectors other than BigQuery, and deleting datasources.

Configuration

All optional.

Variable

Default

Meaning

DATASTUDIO_PROFILE_DIR

~/.datastudio-mcp/profile

Chrome profile with the Google sign-in

DATASTUDIO_STATE_DIR

~/.datastudio-mcp/state

Operation journal (before-states for undo)

DATASTUDIO_CHROME_BINARY

macOS Google Chrome

Chrome executable

DATASTUDIO_IDLE_CLOSE_S

600

Close Chrome after this many idle seconds; 0 keeps it open

DATASTUDIO_SERVICE_ACCOUNT_TEMPLATE

—

Default for datasource_credentials_set, e.g. datastudio-viewer@{project}.iam.gserviceaccount.com

Pass them with claude mcp add -e NAME=value … or codex mcp add --env NAME=value ….

Security and privacy

  • The profile directory contains your Google session cookies. Treat it like a password: never share it or commit it.

  • The MCP exposes no tool that runs arbitrary JavaScript or calls arbitrary endpoints.

  • The operation journal stores before-states of your reports locally; it never leaves your machine.

  • Report security issues privately: open a GitHub security advisory.

Stability

The MCP talks to the Datastudio web editor, which has no public compatibility guarantee. When Google changes the editor, affected tools fail loudly with *_CONTRACT_CHANGED instead of writing something wrong; bundle_contracts shows exactly what moved.

Development

uv sync --frozen
uv run pytest -q          # offline tests; nothing launches a browser or touches a report

Engineering rules for contributors and coding agents: CLAUDE.md. Release notes: CHANGELOG.md.

License and permitted use

Copyright (c) 2026 Max Omen. Licensed under the PolyForm Noncommercial License 1.0.0.

You may, free of charge:

  • use it for personal projects, study, research and experiments;

  • use it in charitable, educational, public research, public health or government organizations;

  • read, modify and share the source for those noncommercial purposes, keeping the license and the Required Notice line.

You may not, without a commercial license:

  • use it for any commercial purpose — at or for a company, for clients, in paid services, consulting or internal business reporting;

  • sell it, resell it, offer it as a hosted service, or ship it inside a commercial product;

  • remove or change the license and copyright notices, or present the software or a derivative of it as your own product.

Commercial license: open an issue titled Commercial license or contact @maxokhrimenko on GitHub.

The software is provided as is, without warranty. You are responsible for what you do with your reports and data through it.

Trademarks

Google, Datastudio, Looker Studio and Chrome are trademarks of Google LLC. This project is an independent product and is not affiliated with, endorsed or sponsored by Google.

Available Tools

109 tools
bigquery_browseBigquery BrowseA
Read-only

Browse BigQuery as Add data > BigQuery does: projects (no args; recent=true for Recent projects), datasets of project_id, or tables of project_id+dataset_id. Uses the signed-in account's access. Read-only.

Inputs: recent, report_id, dataset_id, project_id. Returns: object

blend_createBlend CreateA

Create a blend (Resource > Manage blends > Add a blend).

blend: {name, tables: [{datasource_id, dimensions: [field names], metrics: [{name, aggregation?}]}] (2-5 tables attached to the report, fields from datasource_get), joins: one per table after the first, in order: {join_type (LEFT_OUTER_JOIN default, INNER_JOIN, RIGHT_OUTER_JOIN, FULL_OUTER_JOIN, CROSS_JOIN, UNION), keys: [{left_table (earlier table index), left_field, right_field}]}} - key fields must be listed as dimensions. Output fields are built by the editor's own blend schema builder. Fingerprint from blends_list. Result blend_id is the datasource ID for components_create; output field names are what charts use. Input datasources need their schema loaded in the editor (SCHEMA_NOT_READY: use one in any chart first, or report_refresh). Table names, input filters and the date range dimension are set afterwards with blends_inputs_rename / blends_input_filters. One journalled report write, restorable with operation_restore.

Inputs: blend (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blend_getBlend GetB
Read-only

Read one full saved data-view definition, queries, joins and reference paths.

Preserves opaque server fields. Input/join paths are relative to the returned definition, reference paths are absolute within reportConfig. No live-query execution or datasource/report asset operation is performed.

Inputs: blend_id (required), report_id. Returns: object

blend_join_typesBlend Join TypesA
Read-only

Read current native blend merge types and Union feature availability.

Resolves the selector enum from the connected browser, without saving or changing the report. Union uses its own saved tree node, unlike ordinary joins. Availability does not imply this MCP can yet write all join types or that any particular input/key configuration is valid.

Inputs: report_id. Returns: object

blends_deleteBlends DeleteA
Destructive

Remove blends from the report (Manage blends > Remove). Refused while a component, filter or other resource still references a blend. One journalled report write, restorable with operation_restore.

Inputs: blend_ids (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blends_input_filtersBlends Input FiltersA
Destructive

Replace filter lists on 1-100 distinct saved blend inputs in one report write.

Use exact input_path and report fingerprint from blends_list. filter_ids is the complete list; [] clears it. Only saved filters belonging to the input datasource can be attached; source must be attached with matching draft and published definitions. Clearing does not require access to an old source. Preserves joins, fields, other input settings and consumers. Validates filters against native source schemas, not query execution. Preview by default; undo uses operation_restore. Does not edit or publish datasource assets.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blends_inputs_renameBlends Inputs RenameA
Destructive

Rename 1-100 input table labels using exact paths from blends_list.

Changes only query.displayName. Empty name removes the custom label and restores the native default; maximum 100 UTF-16 code units. Duplicate names are permitted, repeated target inputs are not. Preserves source IDs, concept IDs, fields, joins, filters and unknown properties. Historical missing sources do not prevent label-only edits. Preview by default; one guarded report write and operation_restore for applied changes.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blends_joinsBlends JoinsA
Destructive

Change merge types/key pairs on 1-100 distinct saved blend nodes.

Use exact join_path and fingerprint from blends_list. key_pairs omitted preserves existing keys; Cross explicitly removes conditions. Non-cross merges need keys; provide them when converting from Cross. Pair names are input concept IDs (not output labels), as shown by blend_validate/blend_get. Union requires the current native feature flag. Source draft/published equality and native structural candidate validation precede a single guarded report write. Unknown unrelated fields and all input/output fields survive. No query-result or cross-source type-compatibility guarantee. Preview by default; applied changes are reversible through operation_restore.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blends_listBlends ListB
Read-only

List report-local data views: inputs, joins, filter IDs and exact references.

Includes single-query views, not only multi-source blends. Join type codes are returned without guessing enum meanings. Missing attached sources, unknown tree shapes and dangling dataset bindings are reported. No mutation, schema validity, runtime usage or deletion safety is inferred from this list.

Inputs: report_id. Returns: object

blends_renameBlends RenameA
Destructive

Rename 1-100 report-local data views by ID, in one guarded report write.

Get the fingerprint from blends_list. Changes only datasourceBlock.name; preserves queries, joins, fields, IDs, bindings and unknown values. Names need not be unique. Does not rename/create/publish datasource assets. Missing historical input sources do not prevent this label-only edit. Preview by default. Applied edits have durable read-back and operation_restore.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

blend_validateBlend ValidateA
Read-only

Validate a saved blend using the current native detached runtime model.

Returns native structural issue codes, runtime joins and normalization paths. Requires fresh saved/native report state; does not save or execute queries. Structural validity is not source/schema compatibility or feature availability. Use blend_join_types separately for the current Union flag. Non-left-deep trees remain visible in blend_get but this native validator rejects them. Optional rebuild_output_schema recomputes output fields on the detached model using current native source metadata and returns rebuilt_output_fields. Requires attached inputs with equal draft/published source definitions and source freshness checks. Does not save normalization or query the data.

Inputs: blend_id (required), report_id, rebuild_output_schema. Returns: object

bundle_contractsBundle ContractsA
Read-only

Check every native capability the MCP relies on against the loaded editor.

Data Studio's minified bundle renames members on each release. Tools resolve them by behaviour at call time; this reports, per contract, ok (with the name it resolved to), changed (with the reason) or not_testable (no live object of that kind in this report). Run it first when a tool fails with NATIVE_CONTRACT_FAILED or *_CONTRACT_CHANGED: a changed entry names exactly which signature in bundle.py must be updated. Read-only.

Inputs: report_id. Returns: object

community_viz_listCommunity Viz ListB
Read-only

Community visualizations registered in the report (Manage community visualizations), the components using each, and the fingerprint for writes.

Inputs: report_id. Returns: object

community_viz_registerCommunity Viz RegisterA
Destructive

Add (or with register=false remove) a community visualization to the report (needed before components_create can use its type). viz_id: manifest path (gs://bucket/path or google://...) plus U+00A0 and the component ID, e.g. "google://devrel/googlecharts gauge", "gs://datastudio_visualizations/funnel/v4/prod pmaMetricFunnel". Then components_create with type=viz_id (no explicit fields: the editor binds its defaults; adjust data slots with components_patch). Removal is refused while components use it. Journalled, verified, restorable.

Inputs: viz_id (required), expected_fingerprint (required), dry_run, register, +1 more. Returns: object

component_interaction_stateComponent Interaction StateA
Read-only

Read current native viewer selection, reset availability and inherited filters.

Returns onSelect behavior/default init separately from its runtime value, inherited cross-filters and slider filters. Effective filters are reported as unavailable (not_exposed_by_bundle), never as an empty-filter success. This is browser-session state, not a saved configuration edit or proof of query/data results. Rejects stale/dirty native models; report_refresh resets viewer state. No selection, reset, query refresh or report write is performed by this tool.

Inputs: page_id (required), component_id (required), report_id. Returns: object

components_arrangeComponents ArrangeA
Destructive

Align or distribute unrotated, ungrouped leaf components on a static page.

Align 2–100 objects against their selection bounds, not canvas bounds. Distribute 3–100 objects with equal edge gaps, holding first/last positions fixed. Negative gaps (overlap) are allowed. Stable position ties preserve input ID order. Computed coordinates truncate toward zero to integer pixels as updatePage does; preview includes requested and persisted coordinates. Sizes, opposite-axis positions, styles and layers remain unchanged. report_refresh first; page_get fingerprint; one versioned page write with preview/read-back/journal/undo. Groups/responsive are separate.

Inputs: action (required), page_id (required), component_ids (required), expected_fingerprint (required), +2 more. Returns: object

components_copy_to_pageComponents Copy To PageB
Destructive

Copy components to another page (copy + paste): same geometry, settings and fields, new IDs. Ungrouped top-level components; conditional formatting rules are not copied. One journalled, verified, restorable write of the target page.

Inputs: component_ids (required), source_page_id (required), target_page_id (required), dry_run, +1 more. Returns: object

components_createComponents CreateA
Destructive

Create a batch of native preset components on a loaded static page.

Use native_catalog for type/preset IDs and datasource_get for field names. Metrics require explicit aggregation using the source/editor enum, not a guessed default. Fields accept name or validated expression, plus optional display_name; aggregate expressions require AUTO (7). New components cannot retain concept_name from another component. Primary dimensions/metrics are supported; presets needing other bindings fail native validation. Composite/responsive creation is not yet supported. All drafts are validated before one versioned page write. Preview IDs are provisional. operation_restore removes the added components if no later changes conflict. Does not create datasource/report assets.

Inputs: page_id (required), new_components (required), expected_page_fingerprint (required), dry_run, +1 more. Returns: object

components_deleteComponents DeleteA
Destructive

Delete ungrouped top-level components and their owned formatting in one page write.

Does not delete datasource assets, fields or report resources. Group membership is guarded. operation_restore can recreate deleted components from the journal.

Inputs: page_id (required), component_ids (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

components_duplicateComponents DuplicateA
Destructive

Copy ungrouped top-level components on the same static-canvas page in one write.

Load the page using report_refresh first. Preserves fields/styles, regenerates IDs/control aliases and copies owned conditional formatting. New objects are appended to the component list, offset in pixels. Preview IDs are provisional. Grouped/responsive/component-child operations require separate support.

Inputs: page_id (required), component_ids (required), expected_fingerprint (required), dry_run, +3 more. Returns: object

components_fieldsComponents FieldsA
Destructive

Replace primary field lists and chart-local display names with native setters.

Omit a role to keep it; [] requests clearing it, subject to native validation. Dimension-filter controls use native controlField/filterMetric bindings. Fields use names from datasource_get and metrics need explicit aggregation. Sources and source field definitions are unchanged. Set concept_name to an existing qt_* name from page_get to retain its ID and unmentioned metadata; otherwise creates a fresh chart-local concept. Independent sort dependencies are retained by Google, even when their fields are no longer visible. Preview returns the full updated components for review. Loaded static ungrouped components only; unsupported preset/UI dependencies are rejected. Formula selections use expression instead of name and run formula_validate before writing. Aggregate expressions require aggregation=7 (AUTO); row formulas need an explicit outer aggregation when used as metrics. Formula writes currently require identical draft/published datasource definitions. Other field roles, drill-down and datasource switching remain unsupported.

Inputs: page_id (required), selections (required), expected_page_fingerprint (required), dry_run, +1 more. Returns: object

components_filtersComponents FiltersA
Destructive

Set saved filter bindings and inheritance on components within one page.

Each change: component_id, optional filter_ids (complete ordered list; [] clears local bindings), optional inherit_filters. Omitted/null properties stay unchanged. Get fingerprints from page_get and filters_list; refresh the viewer before preparation. Native component-schema validation rejects incompatible filters; direct attached datasources with matching draft/published required. Does not create/delete resources or mutate viewer control selections. Page journal/read-back/undo also guard report resource changes. Not a cross- entity transaction or proof of query results. Page/group/report-level binding and blend datasets need their own operations. Preview by default; no publication.

Inputs: changes (required), page_id (required), expected_page_fingerprint (required), expected_report_content_fingerprint (requir… Returns: object

components_geometryComponents GeometryA
Destructive

Set absolute pixel positions/sizes for 1–100 components in one page write.

Only ungrouped top-level leaf components on a static canvas. Load the page with report_refresh first; use page_get's fingerprint. Unspecified geometry and all unknown fields are retained. Values truncate toward zero to whole pixels; preview shows requested and after values. Dimensions must remain at least one pixel. Does not scale children, change layers, or change rotation. Supports preview, durable journal, independent read-back and operation_restore.

Inputs: changes (required), page_id (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

components_layersComponents LayersA
Destructive

Change stacking of 1–100 top-level components on one ungrouped static page.

Actions: bring_to_front, send_to_back, bring_forward, send_backward. Preserves relative order inside selected and unselected subsets, independent of input ID order. At the requested boundary returns unchanged without a write. Component payloads, child order, geometry and conditions are preserved. Preview lists full before/after order back-to-front. report_refresh first, page_get fingerprint, versioned write/read-back/journal/operation_restore. Grouped and responsive pages and report-level layers need separate support.

Inputs: action (required), page_id (required), component_ids (required), expected_fingerprint (required), +2 more. Returns: object

components_patchComponents PatchA
Destructive

Patch existing components on ONE page in a single versioned write.

Each change identifies a component and RFC 6902 add/replace/remove/test operations relative to that component. Preserve all unknown fields. Use page_get's fingerprint. Geometry is in attributeConfig.componentAttribute; styles and bindings are in propertyConfig.componentProperty and conceptDefs. dry_run previews changes without a remote write. Returns a durable operation ID and read-back status. Does not change a component's ID or datasource.

Inputs: changes (required), page_id (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

components_scopeComponents ScopeA
Destructive

Arrange > Make report-level (to="report": the components show on every page) or Make page-level (to="page": report-level components move onto page_id). Ungrouped top-level components without conditional formatting. Two journalled writes (target first, then source); a failure between them is returned as partial, never lost.

Inputs: to (required), page_id (required), component_ids (required), dry_run, +1 more. Returns: object

components_switch_typeComponents Switch TypeA
Destructive

Convert chart types/presets through isolated native editor transformations.

Preview exposes all changed/removed settings and before/after bindings. Optional dimensions/metrics select source fields or validated expressions before validation; omitted roles retain native conversion, empty lists clear a supported role. Metrics require explicit aggregation; aggregate expressions use AUTO (7). concept_name retains an existing local field ID. Special roles remain separate work. Non-preview writes require allow_loss when settings or fields disappear/change. Same datasource, static ungrouped non-composite charts; conditional formatting remapping and other contexts remain separate work. Requires report_refresh, page_get fingerprint and matching datasource draft/published. One journaled page write/read-back/undo. No claim of equivalent rendering or numeric results.

Inputs: changes (required), page_id (required), expected_fingerprint (required), dry_run, +2 more. Returns: object

control_checkbox_setControl Checkbox SetA
Destructive

Set a rendered non-parameter checkbox in the current View document.

True/False select a boolean filter; null clears it (not reset-to-default). Get the fingerprint from component_interaction_state. Durable before-state, native same-document conflict guard and read-back; no automatic retries. operation_restore restores its previous runtime state only in that same document, rejecting intervening changes. Reload expires runtime recovery. Does not change saved defaults. Verification covers control state and saved page, not consumer query completion. Parameters/Analysis are unsupported.

Inputs: value (required), page_id (required), component_id (required), expected_interaction_fingerprint (required), +2 more. Returns: object

control_date_range_setControl Date Range SetA

Set an absolute YYYYMMDD runtime range on a date-range control.

Uses the component's native onSelect behavior. Browser-session-only, previewed, conflict-guarded, journalled, read back and reversible in the same document. Saved defaults are unchanged; control_reset returns to the saved default.

Inputs: value (required), page_id (required), component_id (required), expected_interaction_fingerprint (required), +2 more. Returns: object

control_filter_setControl Filter SetA

Set the runtime condition/value of a rendered dimension filter control.

Supports non-parameter list/input/advanced/slider presets through the native canvas-control editor. The saved bound concept is immutable here: the tool builds the filter on the control's actual concept and validates it against the native condition/schema contract. Get the interaction fingerprint from component_interaction_state. Browser-session state only; preview by default, journalled dispatch/read-back, and operation_restore while the document lives. Checkbox has a stricter dedicated tool; parameters and Analysis are rejected.

Inputs: value (required), page_id (required), component_id (required), expected_interaction_fingerprint (required), +2 more. Returns: object

control_parameter_setControl Parameter SetA

Set typed runtime values on the parameter bound to a rendered control.

The parameter key is read from the native component and cannot be redirected by the caller. Values use stringValue, numberValue or boolValue wire fields. The action is browser-session-only, previewed, conflict-guarded, journalled, read back and reversible in the same document with operation_restore.

Inputs: values (required), page_id (required), component_id (required), expected_interaction_fingerprint (required), +2 more. Returns: object

control_resetControl ResetA

Reset a rendered filter, parameter or date control to its saved default.

Uses stateActionService's addressable reset, not a page-wide reset or DOM keystrokes. Requires a current interaction fingerprint. Browser-session state only; dispatch is journalled and read back, and operation_restore can restore the pre-reset runtime value while the same browser document remains alive.

Inputs: page_id (required), component_id (required), expected_interaction_fingerprint (required), dry_run, +1 more. Returns: object

datasource_add_to_reportDatasource Add To ReportA

Add an existing datasource to the report (Add data > My data sources): names it in the report's datasourceAlias and verifies the report lists it as attached. Idempotent. Remove with datasources_remove_from_report.

Inputs: datasource_id (required), report_id. Returns: object

datasource_calculated_fields_createDatasource Calculated Fields CreateA
Destructive

Validate and create calculated fields in an attached datasource.

Requires matching draft/published and datasource_get fingerprint. Expressions reference existing internal fields (t0.revenue); no within-batch references. Explicit aggregation is required; aggregate expressions require AUTO (7). Preview IDs are provisional. Publishes the full source draft once and reads both states back. operation_restore restores its recorded before-state. Does not create a datasource asset. Row/aggregate creation and undo were verified live; numeric results and all formula types remain unverified.

Inputs: fields (required), datasource_id (required), expected_fingerprint (required), dry_run, +2 more. Returns: object

datasource_calculated_fields_deleteDatasource Calculated Fields DeleteA
Destructive

Delete unused user-created calculated fields from an attached datasource.

Fail-closed safety checks cover the native datasource formula dependency graph and identifier-token references across the full saved report, all pages and resources. Ownerless report matches are blockers; matches explicitly scoped to another datasource are informational. A batch may delete fields that depend on each other, but any dependent outside the batch blocks it. Requires complete formula parsing, matching draft/published, datasource fingerprint, and an unchanged report through the final preflight. Preview by default; publication is journaled, read back, and reversible with operation_restore.

Inputs: field_names (required), datasource_id (required), expected_fingerprint (required), dry_run, +3 more. Returns: object

datasource_calculated_fields_editDatasource Calculated Fields EditB
Destructive

Edit datasource formulas/labels/aggregation while retaining calc field IDs.

Shared sources require explicit opt-in; unrelated unpublished drafts are rejected. Publishes full draft with journal/read-back/operation_restore. A formula may reference other calculated fields (t0.calc_*); an edit that would close a reference loop is refused with FORMULA_CYCLE. Existing chart references keep their IDs, but new semantics may affect them. ABS/SUM edits with retained IDs, reload and undo verified live. Consumer effects, numeric results and dependency-aware formula edits remain pending.

Inputs: fields (required), datasource_id (required), expected_fingerprint (required), dry_run, +2 more. Returns: object

datasource_create_bigqueryDatasource Create BigqueryA

Create a BigQuery datasource from a table or a custom query (Add data > BigQuery).

source: {project_id, dataset_id, table_id} for a table, or {project_id (billing project), sql, legacy_sql?, date_range_params?, viewer_email_param?} for a custom query (the params enable @DS_START_DATE/@DS_END_DATE and @DS_USER_EMAIL); optional name, billing_project_id. With a report (active or report_id) and attach_to_report it is embedded in that report and named in its datasourceAlias, ready for components; otherwise a reusable datasource owned by the account. dry_run reads the connector fields (validating access/SQL) without creating anything. Field names in the result are what components_create and formulas use.

Inputs: source (required), dry_run, report_id, attach_to_report. Returns: object

datasource_credentials_setDatasource Credentials SetA
Destructive

Switch a datasource to Service Account Credentials.

Without service_account, the DATASTUDIO_SERVICE_ACCOUNT_TEMPLATE environment variable names it ({project} = the BigQuery project the source runs in); with neither, the call is refused. datasource_get shows the current credentials. The editing user needs Service Account User on the account. Preview by default; the change is journaled and read back but not restorable, because owner's credentials belong to a person and cannot be replayed.

Inputs: datasource_id (required), dry_run, report_id, service_account, +1 more. Returns: object

datasource_dependenciesDatasource DependenciesA
Read-only

Inspect datasource formula field graph, reverse edges and one cycle if found.

Validates each calculated field sequentially; cost grows with formula count. Requires matching draft/published. Validation failures produce partial output, never proof of no dependencies. Does not cover report consumers or parameters and does not authorize field deletion. No source/report mutation. Optional overrides replace expressions in the inspected graph only, using fully qualified field_id (t0.calc_*). Detects proposed cycles, but expression types are validated against the CURRENT source, not propagated future types.

Inputs: datasource_id (required), overrides, report_id. Returns: object

datasource_fields_edit_metadataDatasource Fields Edit MetadataA
Destructive

Edit field labels, descriptions, types/semantics, aggregation or visibility.

Works for physical and calculated fields while retaining identity and all unspecified/unknown metadata. data_type and semantic_config must be supplied together because changing one alone creates inconsistent field semantics. Type, aggregation, and disabling changes inspect datasource formula dependents and full-report saved references; used fields require allow_in_use=true. Shared sources additionally require allow_shared_source=true and preview reports their external impact scope. Matching draft/published and source fingerprint are required. The report fingerprint is guarded through publication; full-draft publish is journaled, read back, and reversible with operation_restore.

Inputs: changes (required), datasource_id (required), expected_fingerprint (required), dry_run, +3 more. Returns: object

datasource_fields_renameDatasource Fields RenameA
Destructive

Rename datasource field labels, preserving internal IDs and all other definitions.

Shared sources require allow_shared_source=true and report external impact. Requires matching draft/published to avoid publishing human drafts. Get fingerprint from datasource_get. Publishes full draft, independently reads both states, journals before/after for operation_restore. No automatic retry. This API has no characterized server CAS; preflight cannot lock out other clients.

Inputs: changes (required), datasource_id (required), expected_fingerprint (required), dry_run, +2 more. Returns: object

datasource_getDatasource GetA
Read-only

Read a source's draft and published definitions, fields, formulas, types, credentials.

datasource_id is a UUID or a datasource URL. No report is needed; see the datasource-scope rule in the server instructions.

Inputs: datasource_id (required), report_id. Returns: object

datasource_parameters_deleteDatasource Parameters DeleteA
Destructive

Delete unused datasource parameters after conservative dependency checks.

References in datasource formulas and the full configured report block deletion. Shared sources additionally require acceptance that external consumers cannot be inventoried. Publication is previewed, guarded, journalled, read back and undoable.

Inputs: datasource_id (required), parameter_keys (required), expected_fingerprint (required), dry_run, +3 more. Returns: object

datasource_parameters_listDatasource Parameters ListB
Read-only

List lossless datasource parameter definitions and their source fingerprint.

Inputs: datasource_id (required), report_id. Returns: object

datasource_parameters_upsertDatasource Parameters UpsertA
Destructive

Create or replace complete datasource parameter definitions losslessly.

The definition is Data Studio's typed wire from datasource_parameters_list; roles, defaults, options, validation and display metadata are retained exactly. New parameter (Add a parameter): {"parametersModifiedByRoles": [{"key": 1, "value": {"name": K, "dataType": 1 text | 2 number | 4 boolean, "lock": 2, "options": [], "validation": {}, "defaultValue": [{"label": "0.9", "stringValue": "0.9"}]}}, the same under key 2 without label], "parameterDisplayConfiguration": {"name": K, "displayName": "...", "displayType": 1}}; values are strings for every type. Replacing a referenced parameter requires allow_in_use=true. Shared sources need explicit opt-in. Matching draft/published, fingerprint, full-report guard, preview, read-back and operation_restore apply to the datasource-atomic publish.

Inputs: parameters (required), datasource_id (required), expected_fingerprint (required), dry_run, +3 more. Returns: object

datasource_refresh_fieldsDatasource Refresh FieldsA
Destructive

Refresh fields from the connector, as the datasource editor's REFRESH FIELDS does.

New columns become fields with the connector's defaults. Fields whose column is gone are removed; if a formula or the report in scope uses one, the refresh is blocked unless allow_in_use=true. Surviving fields keep every edit (labels, types, aggregation, descriptions); a column whose type changed is listed in retyped_columns, not retyped. Preview by default; publication is journaled, read back and reversible with operation_restore. Single-connector sources only.

Inputs: datasource_id (required), expected_fingerprint (required), dry_run, report_id, +2 more. Returns: object

datasource_renameDatasource RenameB

Rename a datasource (the title in its editor and in Add data / home lists). datasource_get fingerprint; journalled; read back on draft and published.

Inputs: name (required), datasource_id (required), expected_fingerprint (required), dry_run, +2 more. Returns: object

datasource_settings_setDatasource Settings SetC
Destructive

Datasource editor settings: data freshness (cache_hours 0 = every 15 minutes, 1, 4, 12 = default), field editing in reports, community visualizations access, native functions. datasource_get fingerprint; publishes and reads back; restorable.

Inputs: datasource_id (required), expected_fingerprint (required), dry_run, report_id, +5 more. Returns: object

datasource_sharing_getDatasource Sharing GetB
Read-only

Who can open or edit a reusable datasource: members with owner/editor/viewer role, whether this account may share it, and the fingerprint for datasource_sharing_set.

Inputs: datasource_id (required), report_id. Returns: object

datasource_sharing_setDatasource Sharing SetA
Destructive

Give people viewer or editor access to a reusable datasource.

members: [{"email": "...", "role": "viewer" | "editor"}], people without access yet; changing or removing an existing member is refused (a person does it in the Share dialog). Runs the datasource's Share dialog as a person does; notify sends Google's invitation email. Google checks each update with reCAPTCHA and may refuse a long automated series (SHARING_REJECTED). Journalled; read back. Use the exact email the user gave or confirmed; never guess an address.

Inputs: members (required), datasource_id (required), expected_fingerprint (required), notify, +2 more. Returns: object

datasources_listDatasources ListA
Read-only

List the sources attached to a report, or every datasource the account can open.

With all_accessible=true, or with no report open, lists the account's reusable datasources (id, name, owner, modified) without any report. Otherwise lists the sources attached to the report; isEmbedded distinguishes shared sources.

Inputs: report_id, all_accessible. Returns: result

datasources_remove_from_reportDatasources Remove From ReportA
Destructive

Remove a datasource from the report (Manage added data sources > Remove): drops its datasourceAlias and the report's claim. Refused while components, filters, blends or parameters use it. The datasource itself is not deleted.

Inputs: datasource_id (required), dry_run, report_id. Returns: object

dimension_value_colors_setDimension Value Colors SetA
Destructive

Resource > Manage dimension value colors: fixed color per dimension value in every chart (when the theme colors by dimension values). Merges by value unless replace. Max 1500 values. Journalled, verified, restorable.

Inputs: colors (required), dry_run, replace, report_id. Returns: object

field_overrides_listField Overrides ListB
Read-only

Resource > Manage field names and IDs: the report's field overrides ({displayNameOverride, idOverride, originalId, originalName, datasourceId}) and the fingerprint field_overrides_write needs.

Inputs: report_id. Returns: object

field_overrides_writeField Overrides WriteA
Destructive

Override a field's display name and/or ID across this report (Manage field names and IDs). upserts: {datasource_id, field (source field name), display_name?, id_override?}; deletes: {datasource_id, field}. Giving fields of several datasources the same id_override lets one filter or control apply to all of them. The datasource itself is unchanged. Journalled, verified, restorable.

Inputs: expected_fingerprint (required), deletes, dry_run, upserts, +1 more. Returns: object

filter_conditions_listFilter Conditions ListB
Read-only

Read native condition codes, labels and compatible concept data/semantic types.

Current editor catalog, including legacy conditions not offered by every UI. Use filter_validate to check an actual field/tree; catalog membership alone does not establish valid values, regex syntax or datasource compatibility.

Inputs: report_id. Returns: object

filters_createFilters CreateA
Destructive

Create saved filter resources from native-validated predicate/and/or trees.

Each item has name, datasource_id and tree (see filter_validate). Requires attached source with matching draft/published; formulas validated by Google. Preserves all existing resources; one journalled report-resource write and read-back. Does not attach new filters to charts/pages/blends or publish drafts. Preview IDs are provisional. Source checks are preflight, not cross-entity CAS. operation_restore removes the created resources if no later consumers/edits conflict.

Inputs: filters (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

filters_deleteFilters DeleteA
Destructive

Delete unreferenced saved filter resources by ID, never datasource/report assets.

Get fingerprint and inspect exact saved references with filters_list. Rejects bindings on pages, nested/report components, blend inputs and unclassified exact references. No automatic detachment/cascade. Full definitions retained in the journal; operation_restore restores original IDs and registry ordering if no later edits conflict. Preflight/read-back is not a cross-entity lock against another editor adding references concurrently. Preview by default; no automatic publication or mutation retries.

Inputs: filter_ids (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

filters_listFilters ListB
Read-only

Read saved filter resources, full definitions and exact reference locations.

Searches all saved pages, nested objects, report-level content and resources (including blends), not only top-level charts. Distinguishes filter-list bindings from conservative unclassified exact references and reports dangling filter-list IDs. No references is not permission to delete: this is a saved document inventory, not proof of runtime inheritance or external usage. A source absent from attached datasources is labelled, never silently removed.

Inputs: report_id. Returns: object

filters_renameFilters RenameA
Destructive

Rename saved filters by exact ID in one report-resource write.

Get report_content_fingerprint from filters_list. Preserves definitions, IDs, bindings, other resources and report-level components/concepts. A rename may affect labels on many consumers; preview lists saved references. No name matching, source editing or automatic publication. Durable journal, conflict preflight, independent read-back and operation_restore. Does not change filter conditions or create/delete a filter. Unknown outcomes are not retried.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

filters_update_conditionsFilters Update ConditionsA
Destructive

Replace complete condition trees of saved filters by ID in one resource write.

Each change has filter_id and tree (see filter_validate). Keeps the existing datasource, name, filter ID, bindings and opaque entry/value metadata. Replaces the entire filterDefinition and its format version, not individual leaves. Native validation requires an attached source with matching draft/published. Preview includes old/new definitions and exact saved references: changes can affect multiple charts and blend inputs. Source validation is not proof of every consumer query result. Journal, conflict preflight, full read-back and operation_restore; no automatic publication, detachment or mutation retry.

Inputs: changes (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

filter_validateFilter ValidateA
Read-only

Validate predicate/and/or filter trees against an attached datasource.

Predicate: kind=predicate, field={name or expression}, condition=GT/T/IN/etc, include=true/false, string_values/number_values. Group: kind=and/or, children. Metric role requires explicit field aggregation; formulas use server validation. No retained chart concept IDs. Matching source draft/published required; blends and parameter filters are not characterized here. Returned concept IDs are provisional. Success validates configuration, not query results or saved state.

Inputs: tree (required), datasource_id (required), report_id. Returns: object

formula_referencesFormula ReferencesA
Read-only

Validate expression and read direct field occurrences from the native editor AST.

Uses internal ns.field names from datasource_get. String literals are not references. Source fingerprint checked across validation and parsing. Positions are UTF-16 code units, not Python character indices. This is not a transitive dependency graph, parameter inventory or deletion approval.

Inputs: expression (required), datasource_id (required), report_id. Returns: object

formula_validateFormula ValidateA
Read-only

Validate an expression for an attached datasource without saving any field.

Use internal field references, e.g. ABS(t0.revenue), from datasource_get. Returns Google column metadata (dataType, aggregation/type and semantics) or diagnostics. A validation failure may be syntax, schema or connector failure: inspect diagnostics. Uses native uncached revision-0 validation; isolated unpublished-draft and blend contexts are not yet characterized. Success does not prove business correctness or evaluate resulting values.

Inputs: expression (required), datasource_id (required), report_id. Returns: object

groups_createGroups CreateA
Destructive

Create 1–100 ordinary groups from disjoint ungrouped top-level components.

Each group needs 2–100 members. Static canvas only; no regroup/nesting. Defaults come from the native editor. Grouping changes control/filter scope. Preview IDs are provisional; saved component payloads/order stay untouched. report_refresh first, page_get fingerprint, one journaled page write and undo.

Inputs: groups (required), page_id (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

groups_filtersGroups FiltersA
Destructive

Set group filter IDs and/or inheritance in one page-atomic batch.

Each change: group_id, optional filter_ids (complete list, [] clears), optional inherit_filters. Omitted/null properties stay unchanged. Preserves members, child-group links, controlStatePassThrough, geometry and child settings. Native source validation and advisory direct-member compatibility; no claim of full nested-group/blend traversal or effective runtime inheritance. Refresh viewer first; fingerprints from page_get and filters_list. Attached filter sources with matching draft/published required. Guarded journalled page write/read-back/undo; no publication, retries or cross-entity transaction.

Inputs: changes (required), page_id (required), expected_page_fingerprint (required), expected_report_content_fingerprint (requir… Returns: object

groups_moveGroups MoveA
Destructive

Translate 1–100 ordinary groups, preserving their members and settings.

Integer pixel offset_x/offset_y applied equally to every member. Preserves sizes, rotations, relative positions, layer order, group filters/control scope. Static canvas, direct leaf members only; nested/overlapping groups and composites rejected. A zero translation returns unchanged without writing. report_refresh first, page_get fingerprint, preview, one page write and undo.

Inputs: moves (required), page_id (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

groups_ungroupGroups UngroupA
Destructive

Remove ordinary group containers, retaining every component and its order.

Removes group-local filters and returns members to page control/filter scope; inspect removed_groups in preview. No nested or responsive groups. Uses report_refresh, page_get fingerprint, one journaled page write/read-back/undo.

Inputs: page_id (required), group_ids (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

image_exportImage ExportA
Read-only

Save an image component's uploaded file to a local path (a folder keeps the original file name). Read-only for the report; use it to copy images between reports (then image_upload_set).

Inputs: path (required), page_id (required), component_id (required), report_id. Returns: object

image_upload_setImage Upload SetA
Destructive

Upload a local image file (png/jpeg/gif/svg/webp, < 25 MB) into an image component (create one with components_create type image-component). Uses the panel's own upload; one journalled page write, read back, restorable. page_get fingerprint.

Inputs: path (required), page_id (required), component_id (required), expected_fingerprint (required), +2 more. Returns: object

native_catalogNative CatalogA
Read-only

The editor's own catalog of what can be configured.

Default: every component type/preset (name, group, field cardinalities). types (e.g. ["simple-table", "kpi-metric/default"]) adds each one's complete property panel: tabs, sections, every setting's label, control, allowed values, range, binding. panels adds the report (theme/layout/settings) and page panels. full returns all (large; for regenerating docs/inventory/native-catalog.json). Types are created only on the unsaved viewer model, then it is reloaded; nothing is written.

Inputs: full, types, panels, report_id. Returns: object

operation_getOperation GetB
Read-only

Read durable mutation status without dumping the saved report content.

Inputs: operation_id (required). Returns: object

operation_restoreOperation RestoreA
Destructive

Restore a journalled edit or viewer operation if no later edit conflicts.

The journal record names its report; that report is resolved automatically and its tab must be open in the MCP Chrome profile. Preview by default. Restoration is itself journaled and verified. Unknown outcomes need inspection first. Runtime-control recovery additionally requires the original browser document; reload/navigation replacement expires it rather than applying old state to a new session.

Inputs: operation_id (required), dry_run. Returns: object

page_duplicatePage DuplicateA
Destructive

Duplicate a loaded page, retaining fields/styles and sharing its existing sources.

Open the source page in View first. Native duplicateConfig generates component IDs and control aliases; only its delta is applied to full saved JSON, preserving opaque properties. Copies page visibility/icon. Returns a component ID map. Conditions with owners absent from the source page are omitted from the copy as in native duplication; omitted_condition_owner_ids reports them explicitly. This creates a page inside the bound report, never a report/datasource asset.

Inputs: name (required), page_id (required), expected_structure_fingerprint (required), index, +2 more. Returns: object

page_filter_inheritancePage Filter InheritanceB
Read-only

Resolve saved and current runtime filter inheritance for every page component.

The saved view walks report → page → outer/inner groups → component, applies every inheritFilters boundary, and reports nested-group controlStatePassThrough scope. The native view adds provenance layers, runtime cross-filters, validator compatibility for every saved filter against each loaded component schema. Effective runtime definitions are reported as not_exposed_by_bundle: the current bundle no longer exports that resolver. It fails on malformed/ambiguous group ownership, cycles, dirty/stale editor state, or a report change during inspection. Read-only; compatibility does not prove backend query results.

Inputs: page_id (required), report_id. Returns: object

page_filtersPage FiltersA
Destructive

Set page-local saved filter IDs and/or inheritance from report scope.

change.filter_ids replaces the complete list ([] clears); inherit_filters changes inheritance independently; omitted/null properties stay unchanged. Native validation uses each filter's attached source with matching draft and published schema. Preview consumer compatibility is advisory: incompatible consumers may ignore inherited filters, and a compatible one may disable inheritance. Does not rewrite child settings or runtime control selections. Refresh viewer first, use page_get and filters_list fingerprints. One guarded page write/read-back/undo; no automatic publication or cross-entity transaction.

Inputs: change (required), page_id (required), expected_page_fingerprint (required), expected_report_content_fingerprint (require… Returns: object

page_getPage GetB
Read-only

Read a complete page, including components, geometry, styles and field bindings.

Inputs: page_id (required), report_id. Returns: object

page_insert_spacePage Insert SpaceA
Destructive

Make room for a new section: every component starting at or below at_top (pixels) moves down by height, groups as a whole, and the page canvas grows by height. A negative height removes empty space (refused if anything would overlap). One page write with preview, read-back and operation_restore. Static canvas only; page_get fingerprint.

Inputs: at_top (required), height (required), page_id (required), expected_fingerprint (required), +2 more. Returns: object

pages_createPages CreateB
Destructive

Create blank pages inside this report, with names, hidden flag and icons.

index is the top-level navigation insertion position; omitted means append. Get structure_fingerprint from report_inspect. Preview IDs are provisional. Multiple API requests may be needed; inspect partial outcomes, never replay blindly. operation_restore reverses a creation when no later edits conflict.

Inputs: new_pages (required), expected_structure_fingerprint (required), index, dry_run, +1 more. Returns: object

page_screenshotPage ScreenshotA
Read-only

Image of a page's whole canvas as viewers will see it (draft content, after data loads). Use it to check layout and visual design after edits. Read-only.

Inputs: page_id (required), quality, report_id.

pages_deletePages DeleteA
Destructive

Delete selected report pages, not the report asset. Never delete the last page.

Saves complete page definitions and navigation for operation_restore. Restore recreates the original IDs/content then navigation; audit timestamps change. Preview first; references in other entities require separate dependency review.

Inputs: page_ids (required), expected_structure_fingerprint (required), dry_run, report_id. Returns: object

pages_importPages ImportA

Copy pages from another report into this one (copy and paste between reports).

replace={source_page_id: page_id_here} puts a source page's content on an existing page instead of a new one: the page keeps its ID (links, bookmarks), name and navigation place; one journalled page write, undone by operation_restore. Use it to bring a redesign made on a copy back to the original report.

Open both reports with report_open first (the target last, or pass report_id). The source is only read. Brings what the pages need: attaches their reusable datasources, copies the saved filters they reference, creates the pages with conditional formatting (links between imported pages point to the copies), optionally as one navigation section, and re-uploads image files. Each step is journalled and read back; a failure returns status=partial with the steps done. Refuses blends, report variables and datasources embedded in the source. Fingerprint from report_inspect of the target.

Inputs: page_ids (required), source_report_id (required), expected_structure_fingerprint (required), dry_run, +3 more. Returns: object

report_auditReport AuditA
Read-only

Find everything that silently breaks the report or differs for viewers.

Saved rules check every page, filter, blend and attached datasource: filters on ad-hoc formulas ('New field'), fields missing or disabled in their datasource, filters bound where their fields do not exist (silently not applied), detached or dangling datasources/filters/blends, broken datasource field formulas (including columns dropped by a source schema change), unpublished datasource drafts and viewer-credential datasources, chart-local formulas, unused filters and blends. With live=true it also opens each page in the viewer and reports components that render with an error or an invalid configuration, then returns to the starting page (page_ids limits the live pass to those pages). Each finding has rule, severity, meaning, fix and location. healthy=false means at least one error. Read-only; needs the tab in View mode for the live pass.

Inputs: live, page_ids, report_id, live_timeout_seconds. Returns: object

report_content_getReport Content GetB
Read-only

Saved report-level content (attributes, properties, theme and every resource: datasource aliases, parameters, dimension colors, field overrides, report-level components) with the fingerprint report_patch needs. Read-only.

Inputs: report_id. Returns: object

report_filtersReport FiltersA
Destructive

Replace report-level saved filter IDs; [] clears this scope's bindings.

Get fingerprint and IDs from filters_list; refresh viewer before preparation. No inherit flag exists above report scope. Validates filters on their attached sources with matching draft/published. May affect eligible consumers on every page; does not change child inheritance settings. Compatibility diagnostics cover loaded report-level components only, not every child-page consumer. Full report write preserving all other settings/resources and pages, durable journal, conflict/read-back/undo guards; no publication or automatic retries.

Inputs: filter_ids (required), expected_report_content_fingerprint (required), dry_run, report_id. Returns: object

report_inspectReport InspectB
Read-only

Get report identity, navigation, pages, versions and page fingerprints.

Inputs: report_id. Returns: object

report_openReport OpenA

Open a report by URL or UUID in the MCP Chrome profile and make it the default.

Starts the dedicated Chrome profile headless (no window) when it is not running; a window opens only for a Google sign-in and closes after it. Reuses an existing tab of the report or opens one, closes duplicate tabs (editors after their autosave), reopens with the requested account selector, and loads the report draft in View. Returns status=ready with the report inventory; status=login_required when Google needs a sign-in (a window is open: ask the user to sign in there, then call again). access=view means the account cannot edit: saved reads work, native inspection and writes do not.

Inputs: report (required), wait_seconds. Returns: object

report_patchReport PatchA
Destructive

RFC 6902 operations on report_content_get's content, for anything no typed tool covers. Paths are relative to that content (/attributeConfig/reportAttribute/..., /propertyConfig/reportProperty/..., /resource/...). Prefer settings_set: it applies the editor's own rules. One journalled write; read-back; operation_restore.

Inputs: patches (required), expected_fingerprint (required), dry_run, report_id. Returns: object

report_pdfReport PdfB
Read-only

File > Download as > PDF: render the report (all pages in navigation order, or page_ids) with Google's PDF service and save it to a local .pdf path.

Inputs: path (required), page_ids, report_id, page_numbers, +3 more. Returns: object

report_publishReport PublishB
Destructive

Publish the draft to viewers (Publish button), or republish an earlier revision (Version history > Publish this version). Only for manual publishing. Viewers see the result immediately; verified by the published revision read-back.

Inputs: dry_run, report_id, revision_number. Returns: object

report_publishingReport PublishingC
Read-only

Publishing state: auto/manual, published revision, whether the draft has unpublished changes and which pages viewers currently see. Read-only.

Inputs: report_id. Returns: object

report_publishing_modeReport Publishing ModeB
Destructive

File > Publishing settings: auto publishes every saved change (including the current draft, immediately); manual keeps edits in a draft until report_publish.

Inputs: mode (required), dry_run, report_id. Returns: object

report_refreshReport RefreshA
Read-only

Reload the report draft in the MCP tab, optionally on another page.

Tools already reload after writes and when the model is stale; use this to open a specific page (e.g. before page_duplicate) or after edits made outside the MCP. Never discards unsaved editor changes: an open editor is autosaved first.

Inputs: page_id, report_id. Returns: object

report_renameReport RenameB

Rename the report (the title in the header). Verified by read-back. The report description is a settings_set key (reportDescription) on {"kind":"report"}.

Inputs: name (required), dry_run, report_id. Returns: object

reports_listReports ListA
Read-only

List report tabs open in the MCP Chrome profile with mode and which one is active.

Inputs: no named parameters. Returns: result

report_theme_copyReport Theme CopyA
Destructive

Give this report the theme of another report (its custom theme, made active), e.g. after pages_import so the copied pages look exactly like the source. Report-wide: every page here takes it. Open both reports with report_open; the source is only read. Fingerprint from report_content_get. Journalled, restorable.

Inputs: source_report_id (required), expected_fingerprint (required), dry_run, report_id. Returns: object

report_variables_listReport Variables ListA
Read-only

Resource > Manage variables: report variables with their full wire definitions and the report fingerprint for report_variables_write. Read-only.

Inputs: report_id. Returns: object

report_variables_writeReport Variables WriteA
Destructive

Create, replace or delete report variables (Manage variables). Each upsert is {parameter_key, parameter}: parameter is the wire shape report_variables_list returns (parametersModifiedByRoles roles 1 and 5 with dataType, defaultValue, options, optional parameterQueryConfig; parameterDisplayConfiguration.displayName). Deleting a variable still bound by Control visibility is refused. Journalled, verified, restorable with operation_restore.

Inputs: expected_fingerprint (required), deletes, dry_run, upserts, +1 more. Returns: object

revision_name_currentRevision Name CurrentD

File > Version history > Name current version.

Inputs: name (required), report_id. Returns: object

revision_restoreRevision RestoreB
Destructive

Restore a revision of this report (or of a datasource attached to it) as the current draft, as Version history > Restore does; history keeps every revision. Reusable datasources need allow_shared_source. Journalled; verified by the new head revision. Publish separately.

Inputs: revision_number (required), entity, dry_run, entity_id, +2 more. Returns: object

revisions_listRevisions ListB
Read-only

Version history of the report (default) or of a datasource (entity_id).

Inputs: entity, entity_id, report_id. Returns: object

settings_describeSettings DescribeA
Read-only

List every setting of an editor property panel with its current value.

target: {"kind":"report"} (theme, layout, canvas, grid, navigation, report settings), {"kind":"page","page_id":...} (page style, canvas, page data settings) or {"kind":"component","page_id":...,"component_id":...} (every Setup and Style input of any chart/control/text/image/shape, common background/border/header included). Each item: key, label, control, tab, section, value, options (allowed values), min/max, bindings, writable. Search filters by key/label/section. Only inputs the panel currently shows are listed; include_hidden adds the rest (per-series slots, inputs whose UI is conditional). Returns the target fingerprint for settings_set. Read-only.

Inputs: target (required), limit, offset, search, +2 more. Returns: object

settings_describe_pageSettings Describe PageA
Read-only

settings_describe for every component of a page (or the listed ones) in ONE call: {component_id: {type, items}} plus the page fingerprint for settings_set_batch. Use search to keep it small (e.g. "boxShadow"). Far faster than one settings_describe per component. Read-only.

Inputs: page_id (required), search, report_id, component_ids, +1 more. Returns: object

settings_setSettings SetA
Destructive

Change any editor panel settings natively, in one journalled write.

Keys and value shapes come from settings_describe (value = what describe shows, an option's value for dropdowns). Changes apply in order through the editor's own bindings, so dependent settings follow as in the UI; theme settings on a built-in theme first copy it into the report's custom theme (as Customize does). Only the resulting native delta is written over the saved content; read-back verified; operation_restore undoes it. dry_run previews before/after without writing.

Inputs: target (required), changes (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

settings_set_batchSettings Set BatchA
Destructive

settings_set for many components of one page in ONE write: each item is {component_id, changes} (changes exactly as for settings_set). Much faster than one settings_set per component (one read-back and editor reload in total). All or nothing: any refused change aborts the batch with nothing written. page_get fingerprint; journalled; operation_restore undoes it.

Inputs: page_id (required), components (required), expected_fingerprint (required), dry_run, +1 more. Returns: object

theme_from_imageTheme From ImageA
Destructive

Theme > Extract theme from image. Without choice: sends the local image to Datastudio's theme generator and returns up to 3 generated themes (colors, series, palette) plus report_fingerprint; nothing changes. With choice (0-based) and that fingerprint: stores the chosen theme as the report's custom theme and activates it, exactly as the dialog's Apply (fonts and other slots reset to the editor defaults, as in the UI). One journalled report write, restorable.

Inputs: path (required), choice, dry_run, report_id, +1 more. Returns: object

visibility_setVisibility SetA
Destructive

Control visibility: show a component (or the page when component_id is omitted) only when a variable is true / the viewer is in its group. source_key is "REPORT_VARIABLE:" or "DATASOURCE_VARIABLE::"; null removes the rule. page_get fingerprint; journalled and restorable.

Inputs: page_id (required), expected_fingerprint (required), dry_run, report_id, +2 more. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 109 tools

    Disambiguation3/5

    The tool set has many closely related operations across reports, pages, components, filters, blends, and datasources, and several tools overlap in apparent purpose (e.g. report_patch vs components_patch vs settings_set, and the many filter-binding tools). The descriptions are unusually detailed and usually clarify scope, but with 109 tools an agent can still easily misselect among near-neighbors.

    Naming Consistency3/5

    Most names follow a domain_action pattern (report_publish, page_get, components_create), but singular/plural prefixes are inconsistent (datasource_get vs datasources_list, filter_validate vs filters_list, blend_get vs blends_list). Some names are noun-only or action-only (native_catalog, report_audit, visibility_set, theme_from_image), so the convention is readable but not uniform.

    Tool Count1/5

    109 tools is far beyond a well-scoped set and is an extreme mismatch even for a complex report editor. The surface is fragmented into many highly specialized operations, making discovery and correct selection costly.

    Completeness4/5

    The surface covers a very broad lifecycle: reports, pages, components, datasources, filters, blends, controls, publishing, revisions, themes, images, and auditing. Minor gaps remain, such as report creation/deletion, report-level sharing, and datasource deletion or non-BigQuery connector creation.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to create, format, and verify Google Sheets with native tables, themes, validation, linting, rendering, and safeguards for human-edited spreadsheets.
      11 npm
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI apps to plan, build, audit, and report on Google Ads, GA4, Search Console, and Tag Manager accounts through natural language. Accounts are read-only by default, and every change is validated in a preview, applied only after confirmation, logged, and reversible.
      4
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables an AI assistant to explore BigQuery datasets, run read-only queries and create views, then build and refine dashboards in the Looker Studio editor — charts, text, shapes, themes and exact layouts — verifying the result with screenshots. Write actions are gated behind explicit configuration, dry-run and audit logging.
      11
      4
      MIT
    • A
      license
      B
      quality
      B
      maintenance
      Enables AI agents to drive a persistent Chrome session that stays signed in to your own Google account, with tools for navigation, snapshots, clicking, typing, keystrokes, screenshots, JavaScript evaluation, and lifecycle or re-login control. It also exports every row behind a Looker Studio report to CSV and checks whether the session is still healthy.
      14
      MIT