keboola/mcp-server

View on GitHub ↗

Model Context Protocol (MCP) Server for the Keboola Platform

86 ★25 forksPythonUpdated 18d ago

What you need to know

Open-source bridge exposing Keboola data platform capabilities (storage, SQL, transformations, jobs, flows, data apps, metadata, dev branches) as MCP tools for AI assistants.

Install

Remote: paste https://mcp.<YOUR_REGION>.keboola.com/mcp into your MCP client
claude mcp add --transport http keboola https://mcp.<YOUR_REGION>.keboola.com/mcp
Local: uvx keboola_mcp_server --transport <transport>
docker pull keboola/mcp-server:latest

Usage

  • "What buckets and tables are in my Keboola project?"
  • "Run a query to find the top 10 customers by revenue"
  • "Create a SQL transformation that joins customer and order tables"
  • Set KBC_STORAGE_API_URL, KBC_STORAGE_TOKEN, and KBC_WORKSPACE_SCHEMA

Key features

  • Storage, components, SQL transformations, jobs, flows, and data app management
  • Natural-language metadata search and documentation updates
  • Development-branch support with X-Branch-Id scoping
  • Tool authorization via X-Allowed-Tools, X-Disallowed-Tools, and X-Read-Only-Mode headers
  • Hosted remote server with OAuth across every multi-tenant stack
  • stdio and streamable-http transports plus Docker and WSL setup

Best for

Keboola users who want to query data, run pipelines, and manage components from Claude, Cursor, Windsurf, or other MCP clients

Caveats

  • Requires Keboola credentials (KBC_STORAGE_TOKEN) and the region Storage API URL
  • KBC_WORKSPACE_SCHEMA only needed for custom (non-master) storage tokens
  • Master-token access exposes the whole project; prefer limited tokens
  • Long server names may result in tools being filtered out in Cursor
Platforms: macOS · Linux · WindowsClients: Claude Desktop · Claude Code · Cursor · Windsurf · Zed · Replit · Make · Codeium · Sourcegraph
Documentation ↗

Reviewed 2026-08-11

Topics

data-platformetl-pipelinekeboola-platformmcpmcp-servermodel-context-protocol
Stars
86★
Forks
25
Language
Python
License
MIT
Created
2025-01-12
Last push
2026-08-17