MCP server
Spanner MCP Server
- Maintainer
- Official · Google
- Runs
- Remote
- URL
- https://spanner.googleapis.com/mcp
- Connects to
- Google Cloud, Spanner
Install the Spanner MCP Server
Pick your client. Remote first: nothing to install, and you sign in with OAuth where the client supports it. Config shapes checked against each client's docs on 2026-10-25.
Run in a terminal, then /mcp inside Claude Code to sign in. Add --scope project to share it via .mcp.json. docs
claude mcp add --transport http spanner https://spanner.googleapis.com/mcp
Customize > Connectors > Add > Add custom connector, paste this URL and sign in. It syncs to Claude Desktop and mobile. docs
https://spanner.googleapis.com/mcp
The free plan allows one custom connector. On Team and Enterprise an owner adds it under Organization settings > Connectors.
chatgpt.com/plugins > + > Add custom MCP server, paste the URL, set up sign-in and create it as a plugin. Then @-mention it in a chat. docs
https://spanner.googleapis.com/mcp
Workspace admins can turn custom MCP plugins off.
Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs
{
"mcpServers": {
"spanner": {
"url": "https://spanner.googleapis.com/mcp"
}
}
}Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs
{
"servers": {
"spanner": {
"type": "http",
"url": "https://spanner.googleapis.com/mcp"
}
}
}Run codex mcp add spanner --url https://spanner.googleapis.com/mcp (then codex mcp login spanner), or add this to ~/.codex/config.toml. The CLI, IDE extension and Codex app share it. docs
[mcp_servers.spanner] url = "https://spanner.googleapis.com/mcp"
Run in a terminal (-s user adds it for all projects), then /mcp auth to sign in. In ~/.gemini/settings.json the key is httpUrl. docs
gemini mcp add -s user --transport http spanner https://spanner.googleapis.com/mcp
Run in a terminal; it writes ~/.copilot/mcp-config.json. docs
copilot mcp add --transport http spanner https://spanner.googleapis.com/mcp
Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs
{
"mcpServers": {
"spanner": {
"serverUrl": "https://spanner.googleapis.com/mcp"
}
}
}Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs
{
"context_servers": {
"spanner": {
"url": "https://spanner.googleapis.com/mcp"
}
}
}Add to opencode.json in the project (or ~/.config/opencode/opencode.json). Sign in with opencode mcp auth spanner. docs
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"spanner": {
"type": "remote",
"url": "https://spanner.googleapis.com/mcp",
"enabled": true
}
}
}Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs
{
"mcpServers": {
"spanner": {
"url": "https://spanner.googleapis.com/mcp"
}
}
}MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs
{
"mcpServers": {
"spanner": {
"type": "streamableHttp",
"url": "https://spanner.googleapis.com/mcp"
}
}
}Security notes
- The remote server runs at spanner.googleapis.com, hosted by Google. You sign in with OAuth in clients that support it, and it acts with your account's permissions.
- Connect it to a development database or a read-only user first: the model can run writes and deletes if the credentials allow them.
Alternatives
- MCP Toolbox for Databasesofficial · ★ 17k
One server for Postgres, MySQL, SQL Server, BigQuery, AlloyDB, Spanner and more, with tools you define in YAML.
- AlloyDBofficial
Google-hosted server to manage AlloyDB for PostgreSQL clusters and run queries.
- Cloud SQLofficial
Google-hosted server to manage Cloud SQL for MySQL, PostgreSQL and SQL Server instances.
- Convexofficial · ★ 13k
Read tables, run functions and inspect logs of a Convex deployment.
- Firebaseofficial · ★ 4.5k
Firestore, Auth, Data Connect, Storage and Remote Config tools, built into the Firebase CLI.
- Supabaseofficial · ★ 3k
Query Postgres, manage tables, migrations, edge functions and branches in your Supabase projects.
- Qdrantofficial · ★ 1.6k
Store and search memories in a Qdrant vector collection.
- SQL MCP Server (Data API builder)official · ★ 1.5k
Self-hosted server that exposes chosen SQL tables, views and procedures as safe CRUD tools.
Comparing servers for one product? Google Cloud MCP servers
FAQ
What does the Spanner MCP Server do?+
Google-hosted server to manage Spanner instances and databases and run SQL.
Is the Spanner MCP server official?+
Official: built and maintained by Google.
How do I add Spanner to Claude Code?+
Run: claude mcp add --transport http spanner https://spanner.googleapis.com/mcp, then /mcp inside Claude Code to sign in. Add --scope project to share it with your team through .mcp.json.
How do I use the Spanner MCP server in Cursor or VS Code?+
Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("http").
Does Spanner work in ChatGPT and claude.ai?+
Yes, it has a remote URL (https://spanner.googleapis.com/mcp). In claude.ai add it under Customize > Connectors > Add custom connector; in ChatGPT under chatgpt.com/plugins > Add custom MCP server.
What are the alternatives to the Spanner MCP server?+
Other database MCP servers: MCP Toolbox for Databases, AlloyDB, Cloud SQL, Convex and Firebase.