---
title: "Kubernetes MCP Server Setup Guide and Schema"
slug: "kubernetes"
category: "infrastructure"
package: "mcp-server-kubernetes"
transport: "stdio"
canonical: "https://mcp-codex.com/servers/kubernetes"
source: "MCP Codex (https://mcp-codex.com)"
dateModified: "2026-09-28"
---

# Kubernetes MCP Server

> Manage Kubernetes clusters: pods, deployments, services, and Helm charts.

## Overview
Enable AI agents to interact with Kubernetes clusters. List and inspect pods, manage deployments, view logs, apply manifests, and manage Helm releases. Supports kubeconfig-based multi-cluster access.

## Quick Install
```bash
npx -y mcp-server-kubernetes
```

## Client Configurations

### Claude Desktop (`claude_desktop_config.json`)
```json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-kubernetes"
      ]
    }
  }
}
```

### Cursor (`mcp.json`)
```json
{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-kubernetes"
      ]
    }
  }
}
```

### OpenAI Codex CLI (`~/.codex/config.toml`)
```toml
[mcp_servers.kubernetes]
command = "npx"
args = ["-y", "mcp-server-kubernetes"]
```

## Available Tools (5)

- `list_pods`
- `get_pod_logs`
- `apply_manifest`
- `list_deployments`
- `scale_deployment`

## Documentation & Links
- Canonical Web Page: https://mcp-codex.com/servers/kubernetes
- Weekly Protocol Changelog: https://mcp-codex.com#newsletter
- GitHub Repository: https://github.com/containers/kubernetes-mcp-server
- Setup Tutorial Guide: https://mcp-codex.com/articles/kubernetes-helm-mcp