B

BigQuery

Query Google BigQuery datasets via the official Google MCP.

Works with: Claude DesktopCursor

Community server · details last checked

Quick install
npx -y bigquery-mcp

How to install the BigQuery MCP server

Add this to your Claude Desktop MCP configuration:

{
  "mcpServers": {
    "bigquery": {
      "command": "npx",
      "args": [
        "-y",
        "bigquery-mcp"
      ]
    }
  }
}

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "bigquery": {
      "command": "npx",
      "args": [
        "-y",
        "bigquery-mcp"
      ]
    }
  }
}

Built by ContextBoltThis directory is built by ContextBolt: MCP-native memory and SEO tools that run alongside BigQuery in the same client.

Explore ContextBolt

The BigQuery MCP server lets an agent query Google’s data warehouse directly. For anyone whose useful data lives in BigQuery rather than a local file, this is the difference between an AI that can reason about your business and one that can only reason about what you paste into it.

What it actually does

The server authenticates to your Google Cloud project and exposes BigQuery as tools: list datasets, list tables, read a table schema, run a query. The schema step is the important one. Given the real column names and types, the model writes SQL that runs; without it, it writes SQL that looks plausible and fails.

Practical patterns:

  • ‘What tables are in the analytics dataset and how do they join?’
  • ‘Show me weekly signups for the last quarter, split by acquisition channel.’
  • ‘Find the ten queries in this table with the highest null rate on the user id column.‘

Why use it

BigQuery is where a lot of organisations keep the numbers that actually matter, and it is guarded by SQL fluency and access permissions. Putting a natural-language layer in front of it widens who can ask questions without widening who can break things, provided you scope the credentials properly. For anyone who does write SQL, it removes the part where you go and look up the schema.

Gotchas

Cost is the real gotcha and it is easy to miss. BigQuery bills on bytes scanned, a SELECT * against a partitioned table can scan an enormous amount, and an agent iterating on a query will do that several times over. Set a maximum bytes billed limit on the service account before you connect anything. Beyond that, use a read-only service account scoped to the specific datasets you want visible, and expect large result sets to eat your context window if you do not ask for aggregates.

Built by ContextBolt

This directory is built by ContextBolt

We build MCP-native tools that give your AI the context it cannot reach on its own. Bookmarks turns your saved posts into agent-queryable memory. SEO puts live keyword and ranking data inside Claude. Both run alongside BigQuery in the same client.

Explore the products →

BigQuery MCP server: FAQs

Will an agent run up a BigQuery bill?

It can. BigQuery charges by bytes scanned and an agent exploring a large table will scan a lot. Set a maximum bytes billed limit before you connect it.

Does it know my schema?

It can list datasets and tables and read their schemas, which is what stops it inventing column names.

Can it write data?

Depends on the permissions on the service account you give it. Read-only is the sensible default for analysis work.

Is this Google's own server?

This entry is a community server. Google's first-party MCP support has been expanding, so check whether an official option now covers you.