Resources · Claude connector

Claude Google Cloud BigQuery connectorWhat Claude can do in your Google Cloud BigQuery account.

The Claude Google Cloud BigQuery connector exposes 5 tools. 4 read the structure of your projects, 1 runs any SQL, including statements that change data. Below: what Claude can explore, what that one query tool can do, and the roles and limits Google sets.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

What changes for the people who wait on the data team

Most people who need a number from BigQuery do not write SQL. With the connector, you ask Claude in plain words, it finds the right dataset and table, reads how they are built, then writes and runs the query itself. The answer comes back in the chat, next to the question you asked.

Finding where the data lives. A new analyst has no idea which project holds the orders. list_dataset_ids and list_table_ids walk the project and its datasets, so Claude can point at the right table instead of guessing.

Checking a table before trusting it. get_dataset_info and get_table_info return the metadata of a dataset or a table, which is how Claude learns how the data is built before writing anything.

Getting the figure, or a forecast. execute_sql runs the query and returns the result. Google also presents BigQuery's advanced capabilities, forecasting among them, as a way to get higher-order insights.

What Claude will not do here. The query tool runs any statement BigQuery accepts, so it can insert, update, delete or create just as easily as it can read: it is the only one Google does not label read-only. It cannot reach external tables stored in Google Drive, and a query stops after three minutes. Nothing runs on a schedule either: no tool fires when a table is refreshed. For recurring loads, the Google Cloud BigQuery Make integration covers a different job, background scenarios rather than conversation.

Vocabulary

Five words before you plug it in

The vocabulary you will meet while connecting BigQuery.

Connector
The link you set up once between Claude and an account you already have, so Claude can work in that account while it answers you.
Tool
One named thing the connector lets Claude do. Claude picks the ones it needs by itself, and the directory sheet lists them by name.
Authorization
The service's own sign-in screen, where you hand Claude the access it will use later. Given once per person, and taken back the same way.
Approval
The confirmation Claude waits for before it goes through with a change to your account, shown in the chat at the moment it matters.
MCP
The shared standard connectors are built on: it is what lets an assistant such as Claude talk to an outside service like BigQuery.
Connect

Connecting BigQuery to Claude in three steps

  1. 01

    Find BigQuery in Claude

    In Claude's settings, open Customize, then Connectors, and look for Google Cloud BigQuery. On a Team or Enterprise workspace, an Owner or Primary Owner has to switch the connector on before each member can sign in.

  2. 02

    Start the connection

    Click Connect on its row, then sign in with your Google account in the window Google opens itself. If the link breaks later, Disconnect and connect again.

  3. 03

    Read the authorization screen

    Read Google's screen before you accept. It belongs to the service, not to Claude, and it decides what the access covers. You can also withdraw that access later from your Google account.

Tools

The 5 tools, sorted by what they do

Google Cloud BigQuery gives Claude 5 tools: 4 that read your account, 1 that change something in it.

Two groups: what Claude reads about your projects, and the one tool that can also change them. Tool names stay as Claude shows them.

  • 4 read
  • 1 write

What Claude reads (4)

4 tools

Four tools that describe your projects, datasets and tables without touching the data.

list_dataset_ids

Returns the dataset IDs, and the BigLake namespaces, of a Google Cloud project. It is the map Claude reads first in a project it does not know yet.

When it helps
you joined a team last week and want to know what the marketing project actually contains.

Sourcecloud.google.com · September 30, 2026 ↗

get_dataset_info

Brings back the metadata of one dataset or BigLake namespace, so Claude knows what it is dealing with before opening its tables.

When it helps
two datasets have almost the same name and you need to tell the live one from last year's copy.

Sourcecloud.google.com · September 30, 2026 ↗

list_table_ids

Lists the table IDs inside a dataset or BigLake namespace. Claude uses it to narrow a vague question down to the table that holds the answer.

When it helps
a finance lead asks where refunds are stored and nobody on the call remembers.

Sourcecloud.google.com · September 30, 2026 ↗

get_table_info

Returns the metadata of a BigQuery or BigLake table. That is how Claude learns what the table is before it drafts a query against it.

When it helps
you want to check what a revenue table is before comparing two countries from it.

Sourcecloud.google.com · September 30, 2026 ↗

What Claude can change (1)

1 tool

One tool that runs any SQL BigQuery supports. No source describes a confirmation specific to it: the general rule below applies.

execute_sql

Approval: see the rule

Runs a SQL query in the project and hands back the result. Google's own reference lists inserts, updates, deletes and creation statements among what it accepts, and advises the read-only variant whenever possible.

What Claude asks for
no source documents a confirmation before a statement runs, whatever it does, so the general approvals rule below covers it.
When it helps
a sales manager wants last quarter's top ten accounts without filing a ticket.
Watch out
an admin can block it with an IAM deny policy on read-write tools.

Sourcecloud.google.com · September 30, 2026 ↗

Approvals

What Claude checks with you before acting

By default, Claude stops and asks for your go-ahead before each action it takes on an account on your behalf. The request shows up in the chat, right when it matters.

On Team and Enterprise, the owners decide whether a member may let some actions through without being asked every time. They can also limit what a connector may do for the whole organisation, keeping reading open and closing writing, for instance. Google adds its own lock: IAM allow and deny policies, and a deny policy aimed at read-write tools shuts the query tool. And Claude only has your rights: what your Google identity cannot reach, it cannot reach either.

Plans

Which Claude plans include it

Out of the 819 sheets in the official directory, none shows availability by plan. The connector-by-connector answer is not published anywhere: it is a real gap in the catalogue.

The general rule is published: remote connectors are open to every user on Claude, Cowork, Claude Desktop and mobile. On Team and Enterprise, an Owner or Primary Owner turns the connector on for the organisation before members can connect. For the current state of this one, the connector's sheet in the official directory is the place to check. BigQuery's own quotas are Google's business and stay on the Google side.

Limits

Where this connector stops

A connector is not an automation. Claude calls these tools while it answers you: nothing starts when a table is loaded, a job finishes or a number crosses a threshold.

Everything here comes from Google's own documentation: neither Claude's help centre nor Anthropic's developer docs have a page on this connector. The tool list is an observed floor, not a promise, since an admin can open actions no public sheet shows. The partner badge is not a security audit, and Anthropic writes on every sheet that it does not choose a publisher's tools nor guarantee how they behave. Google also documents a read-only query tool that is not on the directory sheet, so here every query goes through the one that can change data. More connectors are listed on the Integrations hub.

Need help

Need help connecting Google Cloud BigQuery to Claude?

A person reads every message.

FAQ

Claude Google Cloud BigQuery connector: common questions

01What can Claude do with the Google Cloud BigQuery connector?
Claude can explore your Google Cloud projects and answer questions from your data. Four tools list datasets and tables and return their metadata, which tells Claude how the data is built. The fifth runs SQL and returns the result, and Google presents advanced capabilities such as forecasting as part of what BigQuery offers. In practice you ask in plain words, and Claude picks the table, writes the query and brings the answer back into the conversation.
02Can Claude change or delete data in BigQuery?
Yes, through one tool. The query tool runs any statement BigQuery supports, and Google's reference lists inserts, updates, deletes and creation statements among them. It is the only tool of the five that Google does not describe as read-only. Whether it can actually change something depends on your IAM roles on the project, and an administrator can block it entirely with a deny policy aimed at read-write tools. Check your roles before relying on it.
03Does Claude ask before running a query that changes data?
By default, Claude asks for confirmation before each action it takes on an account on your behalf. No source describes a confirmation specific to the BigQuery query tool, so this default rule is what covers it. On a Team or Enterprise workspace, owners decide whether members may let some actions pass without being asked, and they can close writing for the whole organisation. Google's deny policies add a second lock on the Google Cloud side.
04Which plans is it available on?
No official source publishes plan availability connector by connector, and no directory sheet displays it. The general rule is that remote connectors are open to every user on Claude, Cowork, Claude Desktop and mobile, with an Owner switching them on first on Team and Enterprise. The connector's sheet in the directory is the only place that shows the current state for your account, so check it there before rolling it out.
05Can Claude see every project in our Google Cloud organisation?
No. Claude works with your Google identity and the IAM roles attached to it, nothing more. Google asks for three roles on the project you want to use: one to call the tools, one to run jobs and one to read the data. A project where you lack them stays out of reach. If an administrator wants to keep reading open but stop changes, Google documents a deny policy that restricts the read-write tool.
06Why does Claude return only part of my BigQuery results?
Because Google caps what a single query can return and how long it can run. Results stop at 3,000 rows, and a query that runs longer than three minutes is cancelled automatically. Tables stored in Google Drive cannot be queried at all through this connector. The usual fix is to ask Claude for a narrower question, an aggregate or a filtered subset, rather than the full table in one go.
07Claude or an automation tool for BigQuery?
They answer different needs, so it depends on the task. Claude works inside a conversation: you ask, it explores, writes a query and explains the result, and nothing else happens once you stop typing. It does not react on its own when a table refreshes or a load completes. Scheduled imports and exports that run in the background are what an automation tool is for; one-off questions and ad hoc analysis are where the connector helps.