# KubeDrive

> KubeDrive is a freemium MCP server for developer tools. Let AI agents read your Kubernetes clusters through 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
- **Platforms:** macOS, Windows, Linux
- **Website:** https://kubedrive.com/docs/ai-agents
- **Repository:** https://github.com/aleksskoz/kubedrive
- **MCP Registry name:** io.github.aleksskoz/kubedrive
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

The server is a local endpoint inside the KubeDrive desktop app, listening on 127.0.0.1 port 47011. Agents authenticate with a client token that starts with kd_, and they never receive a kubeconfig or a cluster token. KubeDrive answers using the connections it already holds: your kubeconfig, SSO sessions and RBAC permissions.

You choose which clusters are shared, and nothing is shared until you tick it. Each cluster has its own rules: limit reads to listed namespaces, hide Secrets entirely, and switch individual write actions on or off. Delete, exec and drain stay off until you enable them.

Reading is free for one agent at a time. Changes made by agents belong to the Pro plan, and every change waits for your Allow in a window that shows the diff. On a protected cluster you type the object's name to confirm. The setup guide covers Claude Code, Codex, Claude Desktop and Cursor.

## Features

- **Local-only endpoint:** The server runs on your computer at 127.0.0.1 and is switched on from the AI Agents window.
- **No kubeconfig for agents:** Agents ask KubeDrive, which answers with its own connections, so no cluster token leaves the app.
- **Per-cluster rules:** Restrict reads to listed namespaces, hide Secrets and choose which write actions are allowed.
- **Approval for changes:** Each agent change waits for your Allow, with a typed object name on protected clusters.
- **Propose-only mode:** An agent's change can be saved as a proposal instead of being applied.
- **Call indicator:** A robot icon in the title bar shows server state and lights up at each agent call.

## Good for

- Ask why a deployment in staging is not ready
- Find the pods that restarted most in the last hour
- Check what a Kubernetes upgrade would break
- Review rightsizing suggestions for a namespace
- Give Claude Code or Codex cluster access without sharing a kubeconfig

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aleksskoz/kubedrive/releases/download/v0.6.6/kubedrive-0.6.6.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/aleksskoz/kubedrive/releases/download/v0.6.6/kubedrive-0.6.6.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "kubedrive": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/aleksskoz/kubedrive/releases/download/v0.6.6/kubedrive-0.6.6.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/aleksskoz/kubedrive/releases/download/v0.6.6/kubedrive-0.6.6.mcpb"
      ],
      "env": {
        "KUBEDRIVE_MCP_TOKEN": "<KUBEDRIVE_MCP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `cluster_problems`: Diagnoses problems across a whole cluster; refused when reads are limited to listed namespaces.
- `upgrade_check`: Lists what the next Kubernetes version breaks.
- `rightsizing`: Suggests resource right-sizing for workloads.

## FAQ

### Does the agent get my kubeconfig?

No. The agent never receives a kubeconfig or a cluster token; KubeDrive answers with its own connections.

### Is it free?

Reading is free for one agent at a time. A second client and changes by agents need Pro, listed at $8 a month or $79 a year, with a 14-day trial.

### Which clients work?

Claude Code, Codex, Cursor, Claude Desktop and other MCP clients; Claude Desktop connects through a small bridge called kubedrive-mcp.

### Can an agent delete or drain without asking?

Delete, exec and drain are off on every cluster until you turn them on, and every change still waits for your Allow unless you set a rule for scale and restart.

### 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/aleksskoz/kubedrive/releases/download/v0.6.6/kubedrive-0.6.6.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-2
