Hetzner Cloud

v1.0.0Cloud Servicesstable

** - A Model Context Protocol (MCP) server for interacting with the Hetzner Cloud API. This server allows language models to manage Hetzner Cloud resources through structured functions.

hetzner-cloud-mcp-servermcpai-integration
Share:
112
Stars
0
Downloads
0
Weekly
0/5

What is Hetzner Cloud?

Hetzner Cloud is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ** - a model context protocol (mcp) server for interacting with the hetzner cloud api. this server allows language models to manage hetzner cloud resources through structured functions.

** - A Model Context Protocol (MCP) server for interacting with the Hetzner Cloud API. This server allows language models to manage Hetzner Cloud resources through structured functions.

This server falls under the Cloud Services category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ** - A Model Context Protocol (MCP) server for interacting w

Use Cases

Manage Hetzner Cloud infrastructure and resources through Claude.
Interact with Hetzner Cloud API using structured MCP functions.
dkruyt

Maintainer

LicenseMIT License
Languagepython
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx hetzner-cloud-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Hetzner Cloud

The Hetzner Cloud MCP server provides AI assistants with full access to the Hetzner Cloud API, enabling them to manage cloud infrastructure through natural language. It exposes tools for creating, listing, and deleting servers, volumes, firewalls, and SSH keys; attaching and detaching volumes; setting firewall rules; and browsing available server types, images, and datacenters. DevOps teams and developers use it to provision and manage Hetzner Cloud infrastructure directly from an AI chat interface without switching to the Hetzner console or CLI.

Prerequisites

  • Python 3.11 or higher
  • A Hetzner Cloud account and project with an API token (generated in the Hetzner Cloud Console under Security > API Tokens)
  • pip or uv for installing Python packages
  • An MCP-compatible client such as Claude Desktop
1

Obtain a Hetzner Cloud API token

Log in to the Hetzner Cloud Console (console.hetzner.cloud), select your project, go to Security > API Tokens, and create a new token with Read & Write permissions. Copy the token — it is only shown once.

2

Clone and install the server

Clone the mcp-hetzner repository and install it as an editable Python package. Alternatively, install directly from GitHub without cloning.

# Option A: Clone and install
git clone https://github.com/dkruyt/mcp-hetzner.git
cd mcp-hetzner
pip install -e .

# Option B: Install directly from GitHub
pip install git+https://github.com/dkruyt/mcp-hetzner.git
3

Create a .env file with your API token

Create a .env file in the directory from which you will run the server. Set HCLOUD_TOKEN to your Hetzner Cloud API token. Optional variables control the server host and port.

# .env file
HCLOUD_TOKEN=your_hetzner_cloud_api_token
# Optional:
# MCP_HOST=localhost
# MCP_PORT=8080
4

Configure your MCP client

Add the Hetzner Cloud MCP server to your MCP client configuration. Pass the HCLOUD_TOKEN as an environment variable so the server can authenticate with the Hetzner API.

{
  "mcpServers": {
    "hetzner-cloud": {
      "command": "python",
      "args": ["-m", "mcp_hetzner"],
      "env": {
        "HCLOUD_TOKEN": "your_hetzner_cloud_api_token"
      }
    }
  }
}
5

Verify the connection

Ask your AI assistant to list servers or available server types. A successful response confirms the API token is valid and the server is connected to your Hetzner Cloud project.

Hetzner Cloud Examples

Client configuration

Claude Desktop configuration to run the Hetzner Cloud MCP server with your API token.

{
  "mcpServers": {
    "hetzner-cloud": {
      "command": "python",
      "args": ["-m", "mcp_hetzner"],
      "env": {
        "HCLOUD_TOKEN": "your_hetzner_cloud_api_token"
      }
    }
  }
}

Prompts to try

These prompts use the Hetzner Cloud MCP tools to manage infrastructure through your AI assistant.

- "List all servers in my Hetzner Cloud project and show their current status"
- "Create a new server named web-01 using the cx22 server type with Ubuntu 24.04"
- "Create a firewall that allows inbound traffic on ports 80 and 443 from any source"
- "Attach the volume named data-vol to server web-01"
- "Show all available server types and their prices in the Falkenstein datacenter"
- "Power off server staging-01 and then delete it"

Troubleshooting Hetzner Cloud

Authentication error: 'invalid_input' or 401 Unauthorized

Check that HCLOUD_TOKEN is correctly set and that the token has Read & Write permissions. Hetzner tokens are project-specific — make sure you generated the token in the correct project. Regenerate the token if necessary as it cannot be retrieved after initial creation.

ModuleNotFoundError when starting the server

Ensure the package was installed successfully by running `pip install -e .` from inside the cloned mcp-hetzner directory, or `pip install git+https://github.com/dkruyt/mcp-hetzner.git`. Use Python 3.11 or higher as required.

Server creation fails with a quota or resource limit error

Your Hetzner Cloud project may have reached its resource limits for the selected server type or datacenter. Check your project quotas in the Hetzner Cloud Console or choose a different server type or location.

Frequently Asked Questions about Hetzner Cloud

What is Hetzner Cloud?

Hetzner Cloud is a Model Context Protocol (MCP) server that ** - a model context protocol (mcp) server for interacting with the hetzner cloud api. this server allows language models to manage hetzner cloud resources through structured functions. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Hetzner Cloud?

Follow the installation instructions on the Hetzner Cloud GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Hetzner Cloud?

Hetzner Cloud works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Hetzner Cloud free to use?

Yes, Hetzner Cloud is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Browse More Cloud Services MCP Servers

Explore all cloud services servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "hetzner-cloud-mcp-server": { "command": "npx", "args": ["-y", "hetzner-cloud-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Hetzner Cloud?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides