# KubeDrive

> KubeDrive is a freemium MCP server for developer tools. Read-only Kubernetes cluster access for AI agents, served by the KubeDrive desktop app. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $8 a month
- **Website:** https://kubedrive.com/docs/ai-agents
- **Repository:** https://github.com/kubedrive/kubedrive
- **MCP Registry name:** io.github.kubedrive/kubedrive
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

KubeDrive answers an agent's questions from the connections the desktop app already holds, so the agent never receives a kubeconfig or cluster token. The server listens on localhost only and stays off until you switch it on from the AI Agents window.

You choose which clusters are shared, and each one can carry its own rules: limit reads to listed namespaces, hide Secrets entirely, allow or block individual write actions, or make agent changes land as proposals. Every change waits for your Allow in a window unless a rule says otherwise. A shared cluster is tied to the API server it pointed at when you ticked it.

Setup snippets are provided for Claude Code, Codex, Cursor and Claude Desktop, which uses a small stdio bridge.

## Features

- **No kubeconfig for the agent:** The agent asks KubeDrive, which reuses your own kubeconfig, SSO sessions and RBAC.
- **Per-cluster rules:** Restrict namespaces, hide Secrets, and toggle each write action per cluster.
- **Approval for changes:** Agent changes wait for your Allow, with delete, exec and drain off by default.
- **Activity indicator:** A title-bar icon shows server state and counts each agent call.
- **Cluster diagnosis tools:** Whole-cluster tools such as cluster_problems and upgrade_check are available when reads are not namespace-limited.

## Good for

- Ask why a deployment in staging is not ready
- Find which pods restarted most in the last hour
- Check a cluster before an upgrade
- Let an agent propose a change for you to review

## Install

### Claude Code (Terminal)

```sh
claude mcp add kubedrive --env KUBEDRIVE_MCP_TOKEN='<KUBEDRIVE_MCP_TOKEN>' -- npx -y https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kubedrive": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `cluster_problems`: Whole-cluster problem scan
- `upgrade_check`: Check readiness for a cluster upgrade

## FAQ

### Does the agent get my cluster credentials?

No. KubeDrive uses its own connections and the agent only gets answers.

### Is it free?

Reading is free for one agent at a time. A second client and agent-made changes need Pro, at $8 a month or $79 a year.

### Can I limit what an agent sees?

Yes, by namespace, and you can hide Secrets entirely for a cluster.

### Is the server reachable from the network?

It runs at 127.0.0.1 on port 47011 on your computer only.

### Is KubeDrive free?

KubeDrive has a free plan, with paid plans for more usage or features. Paid plans start at $8 a month.

### How do I add KubeDrive to Claude Code?

Run this command in your terminal: claude mcp add kubedrive --env KUBEDRIVE_MCP_TOKEN='<KUBEDRIVE_MCP_TOKEN>' -- npx -y https://github.com/kubedrive/kubedrive/releases/download/v0.6.8/kubedrive-0.6.8.mcpb

### What are the best alternatives to KubeDrive?

The closest alternatives to KubeDrive are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/kubedrive
