# Bigquery MCP

> Run read-only BigQuery SQL queries via CLI. Use when user needs to query BigQuery datasets, run SQL against Google BigQuery, or retrieve data from BigQuery tables.

- Skill: `makabakaxy/bigquery-mcp` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add makabakaxy/bigquery-mcp`
- Raw SKILL.md: https://api.skillmd.com/api/skills/makabakaxy/bigquery-mcp/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: makabakaxy (https://skillmd.com/u/makabakaxy)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/makabakaxy/bigquery-mcp

---


# bigquery-mcp (via mcp2cli)

Run read-only BigQuery SQL queries via CLI.

## Shortcuts

- `mcp2cli bigquery <cmd>`

## Commands

### Query
| Command | Description | Example | Ref |
|---|---|---|---|
| `mcp2cli bigquery query` | Run a read-only BigQuery SQL query | `mcp2cli bigquery query --sql 'SELECT * FROM dataset.table LIMIT 10'`<br>`mcp2cli bigquery query --sql 'SELECT COUNT(*) FROM project.dataset.table'` | [ref](reference/query.md) |

## Discover Parameters

Append `--help` to any command for full parameter list:

    mcp2cli bigquery query --help

> **Note**: Use Ref links in the Commands table above to view detailed parameter reference and more examples.

## User Notes

> **MUST READ** [users/skill.md](users/skill.md) for custom workflows and tips.
> **Config**: MCP server settings live in `~/.agents/mcp2cli/servers.yaml` - edit there to take effect.