Skip to content

Commit 4d161bd

Browse files
ericzakariassonminupalaniappan
authored andcommitted
feat(third_party): add Google Cloud BigQuery plugin
1 parent 6cc3241 commit 4d161bd

8 files changed

Lines changed: 141 additions & 0 deletions

File tree

.cursor-plugin/marketplace.json

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -402,6 +402,11 @@
402402
"name": "coinbase",
403403
"source": "third_party/coinbase",
404404
"description": "Check balances, get quotes, and preview or place trades."
405+
},
406+
{
407+
"name": "google-cloud-bigquery",
408+
"source": "third_party/google-cloud-bigquery",
409+
"description": "Explore datasets and tables and run SQL queries."
405410
}
406411
]
407412
}

README.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -81,6 +81,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
8181
| `daloopa` | [Daloopa](third_party/daloopa/) | Cursor | Integrations | Pull source-linked fundamentals, KPIs, filings, and prices. |
8282
| `excalidraw` | [Excalidraw](third_party/excalidraw/) | Cursor | Integrations | Draw and export hand-drawn diagrams from chat. |
8383
| `coinbase` | [Coinbase](third_party/coinbase/) | Cursor | Integrations | Check balances, get quotes, and preview or place trades. |
84+
| `google-cloud-bigquery` | [Google Cloud BigQuery](third_party/google-cloud-bigquery/) | Cursor | Integrations | Explore datasets and tables and run SQL queries. |
8485
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `plugins@cursor.com` in the manifest).
8586

8687
## Repository structure
Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
{
2+
"name": "google-cloud-bigquery",
3+
"displayName": "Google Cloud BigQuery",
4+
"version": "1.0.0",
5+
"minClientVersions": {
6+
"cursor": "3.13.0"
7+
},
8+
"description": "Explore datasets and tables and run SQL queries.",
9+
"author": {
10+
"name": "Cursor",
11+
"email": "plugins@cursor.com"
12+
},
13+
"homepage": "https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp",
14+
"repository": "https://github.com/cursor/plugins",
15+
"license": "MIT",
16+
"logo": "assets/logo.png",
17+
"keywords": [
18+
"google cloud bigquery",
19+
"google cloud",
20+
"bigquery",
21+
"sql",
22+
"analytics",
23+
"data warehouse",
24+
"datasets",
25+
"mcp"
26+
],
27+
"category": "integrations",
28+
"tags": [
29+
"bigquery",
30+
"google cloud",
31+
"analytics",
32+
"sql",
33+
"mcp"
34+
],
35+
"mcpServers": "./mcp.json"
36+
}
Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,9 @@
1+
# Changelog
2+
3+
All notable changes to this plugin will be documented here.
4+
5+
## 1.0.0 — initial release
6+
7+
- Added the `google-cloud-bigquery` MCP server pointing at Google Cloud BigQuery's hosted Streamable HTTP endpoint (`https://bigquery.googleapis.com/mcp`).
8+
- Auth uses OAuth with Google Cloud BigQuery user login — no API key or client ID to configure.
9+
- Logo: Official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile.
Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2026 Cursor
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.
Lines changed: 61 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,61 @@
1+
# Google Cloud BigQuery
2+
3+
Cursor plugin that connects agents to [Google Cloud BigQuery](https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp) through Google Cloud BigQuery's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.
4+
5+
Explore datasets and tables and run SQL queries.
6+
7+
## Install
8+
9+
1. Open **Cursor Settings → Plugins**.
10+
2. Search for **Google Cloud BigQuery**.
11+
3. Click **Install**, then complete the Google Cloud BigQuery sign-in prompt.
12+
13+
Or run `/add-plugin google-cloud-bigquery` in chat.
14+
15+
## MCP
16+
17+
```json
18+
{
19+
"mcpServers": {
20+
"google-cloud-bigquery": {
21+
"type": "http",
22+
"url": "https://bigquery.googleapis.com/mcp"
23+
}
24+
}
25+
}
26+
```
27+
28+
Auth is OAuth. Cursor prompts for Google Cloud BigQuery sign-in when the plugin connects — there is no client ID or personal access token to configure.
29+
30+
## Before you connect
31+
32+
You need a Google Cloud project with the BigQuery API enabled, and your Google account needs the MCP Tool User role (`roles/mcp.toolUser`) plus BigQuery Job User and Data Viewer on that project.
33+
34+
## What agents can do
35+
36+
| Category | Capabilities |
37+
| --- | --- |
38+
| Explore | List datasets and tables and read their metadata and schemas |
39+
| Query | Run read-only SQL, including BigQuery ML functions |
40+
| Write | Run DML and DDL when the account allows it |
41+
| Jobs | Poll results and cancel running query jobs |
42+
43+
The hosted runtime is the source of truth for tool names and schemas.
44+
45+
## Notes
46+
47+
- Queries are billed to the project id passed to the tool.
48+
- Admins can block the write-capable `execute_sql` tool with an IAM deny policy while leaving read-only queries available.
49+
- Grok also offers this connector with service-identity auth; this plugin configures only the user OAuth flow.
50+
51+
## Docs
52+
53+
- Use the BigQuery MCP server: https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp
54+
- Tools reference: https://docs.cloud.google.com/bigquery/docs/reference/mcp
55+
- Server URL: https://bigquery.googleapis.com/mcp
56+
57+
Logo is the official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile.
58+
59+
## License
60+
61+
MIT
10.8 KB
Loading
Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,8 @@
1+
{
2+
"mcpServers": {
3+
"google-cloud-bigquery": {
4+
"type": "http",
5+
"url": "https://bigquery.googleapis.com/mcp"
6+
}
7+
}
8+
}

0 commit comments

Comments
 (0)