Helm Chart CLI

You connect AI assistants to Helm through an MCP server, enabling natural-language requests to install charts, manage repositories, render templates, and perform many Helm operations in Kubernetes. This MCP server acts as a bridge between your assistant workflow and the Helm CLI, simplifying chart management and release operations through conversational commands.

How to use

Use the Helm MCP server with an MCP client to perform common Helm tasks from natural language. You can install charts, upgrade or rollback releases, manage repositories, render templates, validate charts, and inspect release information without leaving your chat or assistant workspace.

How to install

Prerequisites you need before running the Helm MCP server: Python 3.8+, Docker (for containerized deployment), and the Helm CLI installed.

Option 1: Using Docker

# Clone the repository
git clone https://github.com/modelcontextprotocol/servers.git
cd src/helm

# Build the Docker image
docker build -t mcp-helm .

Option 2: Manual installation (Python environment)

# Clone the repository
git clone https://github.com/modelcontextprotocol/servers.git
cd src/helm

# Install dependencies
uv venv
source .venv/Scripts/Activate.ps1
uv pip install -e .

# Run the server
mcp-server-helm

Additional configurations and notes

You can configure how the Helm MCP server is launched from client tooling to support either a containerized path or a local runtime. The example configurations below show how to register the server for an MCP client.

Available tools

helm_completion

Generate autocompletion scripts for various shells. Usage: helm_completion(shell) where shell is one of bash, fish, powershell, or zsh.

helm_create

Create a new chart with a given name. Usage: helm_create(name) with an optional starter.

helm_lint

Validate a chart by running lint checks. Usage: helm_lint(chart_path, values_file, set_values) to verify chart well-formedness.

helm_package

Package a chart into a chart archive. Usage: helm_package(chart_path, destination, app_version, version, dependency_update) to produce a .tgz.

helm_template

Render templates locally and display output. Usage: helm_template(chart, release_name, namespace, values_file, set_values, api_versions, kube_version).

helm_dependency_build

Build dependencies for a chart. Usage: helm_dependency_build(chart_path).

helm_dependency_list

List dependencies for a chart. Usage: helm_dependency_list(chart_path).

helm_dependency_update

Update chart dependencies. Usage: helm_dependency_update(chart_path).

helm_env

Show Helm environment information. Usage: helm_env().

helm_version

Show Helm version information. Usage: helm_version().

helm_install

Install a chart release. Usage: helm_install(chart, release_name, namespace, values_file, set_values, description, wait, atomic, timeout).

helm_uninstall

Uninstall a release. Usage: helm_uninstall(release_name, namespace, keep_history, no_hooks).

helm_upgrade

Upgrade a release. Usage: helm_upgrade(release_name, chart, namespace, values_file, set_values, install, force, wait, atomic, timeout).

helm_rollback

Rollback a release. Usage: helm_rollback(release_name, revision, namespace, wait, force, timeout).

helm_list

List releases. Usage: helm_list(all_namespaces, filter_, namespace, deployed, failed, uninstalled).

helm_status

Display status of a release. Usage: helm_status(release_name, namespace, revision).

helm_history

Get release history. Usage: helm_history(release_name, namespace, max_).

helm_test

Run tests for a release. Usage: helm_test(release_name, namespace, filter_, timeout).

helm_get_all

Get all information about a release. Usage: helm_get_all(release_name, namespace).

helm_get_hooks

Get release hooks. Usage: helm_get_hooks(release_name, namespace).

helm_get_manifest

Get release manifest. Usage: helm_get_manifest(release_name, namespace).

helm_get_metadata

Get release metadata. Usage: helm_get_metadata(release_name, namespace).

helm_get_notes

Get release notes. Usage: helm_get_notes(release_name, namespace).

helm_get_values

Get release values. Usage: helm_get_values(release_name, namespace, all_values).

helm_repo_add

Add a chart repository. Usage: helm_repo_add(name, url, username, password, pass_credentials).

helm_repo_index

Generate an index file for a chart repository. Usage: helm_repo_index(directory, url, merge).

helm_repo_list

List chart repositories. Usage: helm_repo_list().

helm_repo_remove

Remove a chart repository. Usage: helm_repo_remove(name).

helm_repo_update

Update chart repositories. Usage: helm_repo_update().

helm_search_repo

Search repositories for charts. Usage: helm_search_repo(keyword, regexp, version, versions).

helm_search_hub

Search the Helm Hub for charts. Usage: helm_search_hub(keyword, max_results, repo_url).

helm_registry_login

Log in to a registry. Usage: helm_registry_login(registry_url, username, password, insecure).

helm_registry_logout

Log out from a registry. Usage: helm_registry_logout(registry_url).

helm_push

Push a chart to a registry. Usage: helm_push(chart_path, registry_url, insecure, plain_http, force).

helm_pull

Download a chart from a repository. Usage: helm_pull(chart, repo, version, destination, untar, verify, keyring).

helm_show_all

Show all chart information. Usage: helm_show_all(chart, repo, version).

helm_show_chart

Show chart definition. Usage: helm_show_chart(chart, repo, version).

helm_show_crds

Show chart CRDs. Usage: helm_show_crds(chart, repo, version).

helm_show_readme

Show chart README. Usage: helm_show_readme(chart, repo, version).

helm_show_values

Show chart values. Usage: helm_show_values(chart, repo, version).

helm_plugin_install

Install a Helm plugin. Usage: helm_plugin_install(plugin_url, version).

helm_plugin_list

List Helm plugins. Usage: helm_plugin_list().

helm_plugin_uninstall

Uninstall a Helm plugin. Usage: helm_plugin_uninstall(plugin_name).

helm_plugin_update

Update a Helm plugin. Usage: helm_plugin_update(plugin_name).

helm_verify

Verify a signed chart. Usage: helm_verify(path, keyring).