BigQuery Integration
Manage BigQuery list projects, list datasets, list tables, get table, query
The BigQuery integration provides access to manage BigQuery list projects, list datasets, list tables, get table, query through the Integrate MCP server.
Installation
The BigQuery integration is included with the SDK:
import { bigqueryIntegration } from "integrate-sdk/server";Setup
1. Create a BigQuery OAuth App
- Create an OAuth application for BigQuery
- Configure your redirect URI
- Note your Client ID and Client Secret
2. Configure the Integration on Your Server
Add the BigQuery integration to your server configuration. The integration automatically reads BIGQUERY_CLIENT_ID and BIGQUERY_CLIENT_SECRET from your environment variables:
import { createMCPServer, bigqueryIntegration } from "integrate-sdk/server";
export const { client: serverClient } = createMCPServer({
apiKey: process.env.INTEGRATE_API_KEY,
integrations: [
bigqueryIntegration({
scopes: ["https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform"], // Optional
}),
],
});You can override the environment variables by passing explicit values:
bigqueryIntegration({
clientId: process.env.CUSTOM_BIGQUERY_ID,
clientSecret: process.env.CUSTOM_BIGQUERY_SECRET,
scopes: ["https://www.googleapis.com/auth/bigquery", "https://www.googleapis.com/auth/cloud-platform"], // Optional
});3. Client-Side Usage
The default client automatically includes all integrations. You can use it directly:
import { client } from "integrate-sdk";
await client.authorize("bigquery");
const result = await client.bigquery.listProjects({});
console.log(result);If you're using a custom client, add the integration to the integrations array:
import { createMCPClient, bigqueryIntegration } from "integrate-sdk";
const customClient = createMCPClient({
integrations: [bigqueryIntegration()],
});Configuration Options
Prop
Type
Default Scopes
These defaults are applied unless you override scopes in the integration config:
https://www.googleapis.com/auth/bigqueryhttps://www.googleapis.com/auth/cloud-platform
Tools
bigquery_list_projects
List projects
Prop
Type
bigquery_list_datasets
List datasets
Prop
Type
bigquery_list_tables
List tables
Prop
Type
bigquery_get_table
Get table
Prop
Type
bigquery_query
Query
Prop
Type
bigquery_list_jobs
List jobs
Prop
Type
Notes
- Category: Data & BI
- Authentication mode: OAuth