BigQuery
BigQuery MCPData & Enrichment5 actions

BigQuery MCP Server

Let your AI agents run BigQuery for you, safely.

A hosted BigQuery MCP server for Claude, ChatGPT, Cursor and CLI agents. Paste one server URL into your AI client to use its 5 actions. There is nothing to install.

  • Enable or disable every action, per account. Block your agent from doing dangerous actions.

  • Ask in plain English. Pull reports, find insights and take action in BigQuery.

  • 5 read and write actions. Every BigQuery task your agent needs, from reporting to making changes.

  • Built for teams. Invite your team and share one connected account.

Works with
ChatGPTChatGPTClaudeClaudeClaude CodeClaude CodeCodexCodexGemini CLIGemini CLICursorCursorMistralMistralOpenClawOpenClawHermesHermesPerplexityGrokn8nWindsurfVS CodeZed
ChatGPT
BigQuery
ChatGPT
connected to BigQuery MCP
Online
ChatGPT
Actions

Available Actions

5 actions available to automate your BigQuery workflows.

5 actions

BigQuery
Read

Get Table Metadata

Get full metadata for a table or view: schema, row count, size, partitioning, expiration.

BigQuery
Read

Get Table Schema

Get the schema (column names + types) for a table or view.

BigQuery
Read

List Datasets

List all datasets in the connected Google Cloud project.

BigQuery
Read

List Tables

List all tables and views in a dataset.

BigQuery
Write

Run Query

Execute a Standard SQL query and return rows.

Compare

BigQuery MCP servers compared: hosted vs official

Google runs a managed remote MCP server for BigQuery and publishes MCP Toolbox for Databases. They suit teams that manage access through Google Cloud IAM and only need BigQuery. InsightfulPipe is a hosted alternative with larger result sets, team roles and your marketing platforms in the same workspace.

HostingHosted by InsightfulPipe: paste one URLGoogle-managed endpoint, enabled with the BigQuery API
AuthenticationService account JSON key for one Google Cloud projectOAuth 2.0 with IAM; MCP Tool User, BigQuery Job User and BigQuery Data Viewer roles
SQLrun_query: a single SELECT runs as a read; other SQL is a write limited to owners, admins and operatorsexecute_sql and execute_sql_readonly
Result limitsUp to five minutes of waiting and 10,000 rowsThree minutes of processing and 3,000 rows
Other platformsAds, analytics, e-commerce and data platforms in the same workspace, plus a CLIBigQuery only
Overview

What you can do with the BigQuery MCP

The InsightfulPipe BigQuery MCP server is a hosted Model Context Protocol server that connects a Google Cloud project's BigQuery data to AI assistants such as Claude, ChatGPT, Cursor, Claude Code, Gemini CLI and Codex. You upload a service account JSON key for the project and add one server URL to your AI client.

ClaudeBigQueryAcme StoreRead-only
Ask about your BigQuery account…
01Explore an unfamiliar warehouse

Explore an unfamiliar warehouse

List datasets and tables, and read schemas, row counts, sizes and partitioning before writing a query.

See all BigQuery actions
ClaudeBigQueryAcme StoreRead-only
Ask about your BigQuery account…
02Ask questions in plain English

Ask questions in plain English

The assistant writes Standard SQL, runs it and summarizes the rows it gets back.

See all BigQuery actions
ClaudeBigQueryAcme StoreRead & Write
Ask about your BigQuery account…
03Check query cost first

Check query cost first

Dry-run a query to see how many bytes it would process before you run it.

See all BigQuery actions
5
actions
one server URL
4
read actions
reports, audits, research
1
write actions
create, update, manage
Setup

How to connect the BigQuery MCP server

Add the server URL to your AI client, then sign in with your InsightfulPipe account to authorize access. The server is hosted, so there is nothing to install.

MCP server URL

https://bigquery.insightfulmcp.com/

Connect BigQuery to Claude

Fastest: add InsightfulPipe from the Claude Directory

One click connects the full InsightfulPipe MCP with all your connected accounts. To add a server scoped to BigQuery only, follow the steps below.

Open Claude Directory

Or add the BigQuery server manually:

  1. 01
    Copy the server URL:
    https://bigquery.insightfulmcp.com/
  2. 02
    Open Claude connector settings (Customize > Connectors), click + and then Add custom connector.
  3. 03
    Paste the URL and click Add.
  4. 04
    Click Connect, then click Authorize access in the browser.

Start a new chat, click +, open Connectors and turn the connector on to use it.

The Free plan can add one custom connector. On Team and Enterprise plans, an Owner first adds it under Organization settings > Connectors, then each member clicks Connect in Customize > Connectors.

Watch the setup tutorial

Playbook

Prompts and skills that run on the BigQuery MCP

Copy a prompt into any connected client, or install a Claude skill that chains the actions for you.

Prompt

“Which datasets are in this project?”

Lists datasets in the connected project

Prompt

“Describe the columns in the analytics.events table”

Reads the table schema

Prompt

“How big is the orders table and how is it partitioned?”

Reads table metadata

Prompt

“How many bytes would this query scan?”

Runs the query as a dry run

Prompt

“Top 10 landing pages by sessions last week from our GA4 export”

Writes and runs a SELECT query

Prompt

“What is the latest date in the ads_spend table?”

Checks data freshness with SQL

Prompt

“Count rows with a null user_id in yesterday's events”

Runs a data quality check

HAVE QUESTIONS?

Frequently asked questions

A BigQuery MCP server connects BigQuery to AI assistants through the Model Context Protocol (MCP), an open standard for giving AI tools access to data and actions. Once connected, you can ask Claude, ChatGPT or Cursor questions about your warehouse, and it explores the schema and runs SQL for you.

Ready to connect your data?

Join hundreds of agencies and brands using InsightfulPipe to connect marketing data to AI.

Start a trial today.