Skip to content

Cursor plugin specification and official plugins

TypeScript

feat(third_party): add Google Cloud BigQuery plugin

Minu Palaniappan00ea25b86e12
diff --git a/.cursor-plugin/marketplace.json b/.cursor-plugin/marketplace.json
index 5ff10ceb..0683c253 100644
--- a/.cursor-plugin/marketplace.json
+++ b/.cursor-plugin/marketplace.json
@@ -397,6 +397,11 @@
"name": "excalidraw",
"source": "third_party/excalidraw",
"description": "Draw and export hand-drawn diagrams from chat."
+ },
+ {
+ "name": "google-cloud-bigquery",
+ "source": "third_party/google-cloud-bigquery",
+ "description": "Explore datasets and tables and run SQL queries."
}
]
}
diff --git a/README.md b/README.md
index 6cff83a3..777e787b 100644
--- a/README.md
+++ b/README.md
@@ -80,6 +80,7 @@ Official Cursor plugins for popular developer tools, frameworks, and SaaS produc
| `meltwater` | [Meltwater](third_party/meltwater/) | Cursor | Integrations | Search media and social mentions and pull analytics. |
| `daloopa` | [Daloopa](third_party/daloopa/) | Cursor | Integrations | Pull source-linked fundamentals, KPIs, filings, and prices. |
| `excalidraw` | [Excalidraw](third_party/excalidraw/) | Cursor | Integrations | Draw and export hand-drawn diagrams from chat. |
+| `google-cloud-bigquery` | [Google Cloud BigQuery](third_party/google-cloud-bigquery/) | Cursor | Integrations | Explore datasets and tables and run SQL queries. |
Author values match each plugin’s `plugin.json` `author.name` (Cursor lists `[email protected]` in the manifest).
## Repository structure
diff --git a/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json b/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json
new file mode 100644
index 00000000..37ffa283
--- /dev/null
+++ b/third_party/google-cloud-bigquery/.cursor-plugin/plugin.json
@@ -0,0 +1,36 @@
+{
+ "name": "google-cloud-bigquery",
+ "displayName": "Google Cloud BigQuery",
+ "version": "1.0.0",
+ "minClientVersions": {
+ "cursor": "3.13.0"
+ },
+ "description": "Explore datasets and tables and run SQL queries.",
+ "author": {
+ "name": "Cursor",
+ "email": "[email protected]"
+ },
+ "homepage": "https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp",
+ "repository": "https://github.com/cursor/plugins",
+ "license": "MIT",
+ "logo": "assets/logo.png",
+ "keywords": [
+ "google cloud bigquery",
+ "google cloud",
+ "bigquery",
+ "sql",
+ "analytics",
+ "data warehouse",
+ "datasets",
+ "mcp"
+ ],
+ "category": "integrations",
+ "tags": [
+ "bigquery",
+ "google cloud",
+ "analytics",
+ "sql",
+ "mcp"
+ ],
+ "mcpServers": "./mcp.json"
+}
diff --git a/third_party/google-cloud-bigquery/CHANGELOG.md b/third_party/google-cloud-bigquery/CHANGELOG.md
new file mode 100644
index 00000000..1789565c
--- /dev/null
+++ b/third_party/google-cloud-bigquery/CHANGELOG.md
@@ -0,0 +1,9 @@
+# Changelog
+
+All notable changes to this plugin will be documented here.
+
+## 1.0.0 — initial release
+
+- Added the `google-cloud-bigquery` MCP server pointing at Google Cloud BigQuery's hosted Streamable HTTP endpoint (`https://bigquery.googleapis.com/mcp`).
+- Auth uses OAuth with Google Cloud BigQuery user login — no API key or client ID to configure.
+- Logo: Official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile.
diff --git a/third_party/google-cloud-bigquery/LICENSE b/third_party/google-cloud-bigquery/LICENSE
new file mode 100644
index 00000000..ca2bba77
--- /dev/null
+++ b/third_party/google-cloud-bigquery/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Cursor
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
diff --git a/third_party/google-cloud-bigquery/README.md b/third_party/google-cloud-bigquery/README.md
new file mode 100644
index 00000000..bedfbfe1
--- /dev/null
+++ b/third_party/google-cloud-bigquery/README.md
@@ -0,0 +1,61 @@
+# Google Cloud BigQuery
+
+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.
+
+Explore datasets and tables and run SQL queries.
+
+## Install
+
+1. Open **Cursor Settings → Plugins**.
+2. Search for **Google Cloud BigQuery**.
+3. Click **Install**, then complete the Google Cloud BigQuery sign-in prompt.
+
+Or run `/add-plugin google-cloud-bigquery` in chat.
+
+## MCP
+
+```json
+{
+ "mcpServers": {
+ "google-cloud-bigquery": {
+ "type": "http",
+ "url": "https://bigquery.googleapis.com/mcp"
+ }
+ }
+}
+```
+
+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.
+
+## Before you connect
+
+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.
+
+## What agents can do
+
+| Category | Capabilities |
+| --- | --- |
+| Explore | List datasets and tables and read their metadata and schemas |
+| Query | Run read-only SQL, including BigQuery ML functions |
+| Write | Run DML and DDL when the account allows it |
+| Jobs | Poll results and cancel running query jobs |
+
+The hosted runtime is the source of truth for tool names and schemas.
+
+## Notes
+
+- Queries are billed to the project id passed to the tool.
+- Admins can block the write-capable `execute_sql` tool with an IAM deny policy while leaving read-only queries available.
+- Grok also offers this connector with service-identity auth; this plugin configures only the user OAuth flow.
+
+## Docs
+
+- Use the BigQuery MCP server: https://docs.cloud.google.com/bigquery/docs/use-bigquery-mcp
+- Tools reference: https://docs.cloud.google.com/bigquery/docs/reference/mcp
+- Server URL: https://bigquery.googleapis.com/mcp
+
+Logo is the official BigQuery product icon from Google Cloud's architecture icon set, on a padded white tile.
+
+## License
+
+MIT
diff --git a/third_party/google-cloud-bigquery/assets/logo.png b/third_party/google-cloud-bigquery/assets/logo.png
new file mode 100644
index 00000000..cb2ba563
Binary files /dev/null and b/third_party/google-cloud-bigquery/assets/logo.png differ
diff --git a/third_party/google-cloud-bigquery/mcp.json b/third_party/google-cloud-bigquery/mcp.json
new file mode 100644
index 00000000..4068482c
--- /dev/null
+++ b/third_party/google-cloud-bigquery/mcp.json
@@ -0,0 +1,8 @@
+{
+ "mcpServers": {
+ "google-cloud-bigquery": {
+ "type": "http",
+ "url": "https://bigquery.googleapis.com/mcp"
+ }
+ }
+}