Hetzner

You run the Hetzner Cloud MCP server to expose Hetzner Cloud API operations as MCP tools. This lets you issue natural-language commands to manage servers, networks, volumes, firewalls, and more through any MCP client, with actions executed securely using your Hetzner Cloud API token.

How to use

With an MCP client connected to this server, you can invoke Hetzner Cloud operations by asking in natural language. For example, you can list servers, create a new server with a specific image, attach storage, manage load balancers, or allocate IPs. The client translates your request into MCP tool calls that the server executes against the Hetzner Cloud API. You can combine actions in a workflow, such as creating a private network, provisioning servers in that zone, and connecting them to a load balancer.

To begin, provide your Hetzner Cloud API token to the MCP client configuration so the server can authenticate to Hetzner Cloud for you. The server operates over standard input/output (stdio) or via a dedicated runtime, depending on how you start it.

How to install

Prerequisites you need before installation:

• Node.js 18+

• A Hetzner Cloud API token with appropriate permissions

Install the MCP server using npm (recommended) or run from source.

Install from npm (recommended)

npm install -g hcloud-mcp

Or run without a global install using npx

npx hcloud-mcp

Install from source

git clone https://github.com/Xodus-CO/hcloud-mcp
cd hcloud-mcp
npm install
npm run build

If you install from source, you will run the server using its runtime script directly, as shown in the configuration examples.

Configuration

Configure your MCP client to connect to this server using stdio transport. You must supply HCLOUD_TOKEN in the environment for authentication with Hetzner Cloud.

Example configuration using the npm binary (stdio transport):

{
  "mcpServers": {
    "hetzner-cloud": {
      "command": "npx",
      "args": ["hcloud-mcp"],
      "env": {
        "HCLOUD_TOKEN": "your_hetzner_cloud_api_token"
      }
    }
  }
}

If you installed from source, run the server with an absolute path to the runtime script to ensure it starts from the project directory, even if your MCP client’s working directory differs (for example in dev containers):

"command": "node",
"args": ["/path/to/hcloud-mcp/run.js"]

Available tools

list_servers

Return a list of servers in your Hetzner Cloud account.

get_server

Retrieve details for a specific server.

create_server

Create a new server with specified parameters (name, type, image, location, etc.).

delete_server

Delete a server by ID.

update_server

Modify server properties such as name, labels, or metadata.

change_server_type

Resize a server to a different plan.

power_on_server

Power on a server.

power_off_server

Power off a server.

reboot_server

Reboot a server.

shutdown_server

Shut down a server gracefully.

reset_server

Reset a server to its initial state.

attach_iso

Attach an ISO to a server.

detach_iso

Detach the attached ISO from a server.

attach_server_to_network

Attach a server to a network.

detach_server_from_network

Detach a server from a network.

list_load_balancers

List load balancers in your account.

get_load_balancer

Get details of a load balancer.

create_load_balancer

Create a new load balancer.

update_load_balancer

Update a load balancer.

delete_load_balancer

Delete a load balancer.

add_load_balancer_target

Add a backend target to a load balancer.

remove_load_balancer_target

Remove a backend target from a load balancer.

add_load_balancer_service

Add a service to a load balancer.

update_load_balancer_service

Update a service bound to a load balancer.

delete_load_balancer_service

Delete a service from a load balancer.

list_load_balancer_types

List available load balancer types.

list_networks

List virtual networks.

get_network

Get details for a network.

create_network

Create a new network.

update_network

Update a network properties.

delete_network

Delete a network.

add_network_subnet

Add a subnet to a network.

delete_network_subnet

Delete a subnet from a network.

list_volumes

List storage volumes.

get_volume

Get details of a volume.

create_volume

Create a new volume.

update_volume

Update a volume.

delete_volume

Delete a volume.

attach_volume

Attach a volume to a server.

detach_volume

Detach a volume from a server.

list_firewalls

List firewalls.

get_firewall

Get firewall details.

create_firewall

Create a firewall.

update_firewall

Update firewall rules.

delete_firewall

Delete a firewall.

apply_firewall_to_resources

Apply a firewall to resources.

remove_firewall_from_resources

Remove a firewall from resources.

set_firewall_rules

Set firewall rules for a firewall.

list_floating_ips

List floating IPs.

create_floating_ip

Create a floating IP.

update_floating_ip

Update a floating IP.

delete_floating_ip

Delete a floating IP.

assign_floating_ip

Assign a floating IP to a resource.

unassign_floating_ip

Unassign a floating IP from a resource.

list_primary_ips

List primary IPs.

create_primary_ip

Create a primary IP.

get_primary_ip

Get details of a primary IP.

update_primary_ip

Update a primary IP.

delete_primary_ip

Delete a primary IP.

assign_primary_ip

Assign a primary IP to a server (server must be off).

unassign_primary_ip

Unassign a primary IP from a server (server must be off).

list_ssh_keys

List SSH keys.

create_ssh_key

Create an SSH key.

update_ssh_key

Update an SSH key.

delete_ssh_key

Delete an SSH key.

list_placement_groups

List placement groups.

create_placement_group

Create a placement group.

update_placement_group

Update a placement group.

delete_placement_group

Delete a placement group.

list_locations

List datacenter locations.

list_images

List available images.

list_server_types

List server types.

list_load_balancer_types

List load balancer types.

list_datacenters

List datacenters.

get_pricing

Get pricing information for resources.

list_actions

List asynchronous actions.

get_action

Poll status of a specific action.