How do I use Hetzner MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Hetzner MCP Server list all my servers" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Hetzner MCP Server

by jurislm

Overview Schema Source Related Servers Discussions Admin

TypeScript

Hetzner MCP Server

npm version

An MCP server that gives Claude Code 40 tools to manage Hetzner Cloud — servers, SSH keys, Cloud Volumes, Storage Boxes, and live metrics.

Quick Start

npm install -g @jurislm/hetzner-mcp

Add to your Claude Code MCP config (usually ~/.claude.json — run /mcp to confirm the location):

{
  "mcpServers": {
    "hetzner": {
      "type": "stdio",
      "command": "npx",
      "args": ["@jurislm/hetzner-mcp"],
      "env": {
        "HETZNER_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

Restart Claude Code. Done.

Environment Variables

Variable	Required	Description
`HETZNER_API_TOKEN`	✅	Cloud API token — Read & Write. Generate at console.hetzner.cloud → project → Security → API Tokens.
`HETZNER_API_TOKEN_UNIFIED`	Storage Boxes only	Unified API token for Storage Box tools. Generate at console.hetzner.com/account/security/api-tokens. Falls back to `HETZNER_API_TOKEN` if unset, but a Cloud project token will return `401`.

Why two tokens?

Storage Box tools call api.hetzner.com/v1 (unified API), while all other tools call api.hetzner.cloud/v1 (Cloud API). The two endpoints use different token namespaces. If you want the simplest setup, generate a single unified token from console.hetzner.com and use it for both variables.

Available Tools (40 total)

⚠️ marks destructive or hard-to-reverse operations.

Servers (7)

Tool	Description	⚠️
`hetzner_list_servers`	List all servers — status, IPs, specs, location
`hetzner_get_server`	Get full details for one server
`hetzner_create_server`	Create a new server (billed immediately)
`hetzner_delete_server`	Permanently delete a server and all its data	⚠️
`hetzner_power_on_server`	Power on a stopped server
`hetzner_power_off_server`	Hard power off (equivalent to pulling the power cord)	⚠️
`hetzner_reboot_server`	Hard reboot (equivalent to pressing the reset button)	⚠️

SSH Keys (4)

Tool	Description	⚠️
`hetzner_list_ssh_keys`	List all SSH keys in the project
`hetzner_get_ssh_key`	Get details for one SSH key
`hetzner_create_ssh_key`	Add a new SSH public key
`hetzner_delete_ssh_key`	Remove an SSH key	⚠️

Reference (3)

Tool	Description
`hetzner_list_server_types`	Available server sizes with CPU, RAM, disk, and pricing
`hetzner_list_images`	Available OS images
`hetzner_list_locations`	Available datacenters and their locations

Cloud Volumes (4)

Tool	Description	⚠️
`hetzner_list_volumes`	List all volumes — size, mount path, attached server
`hetzner_get_volume`	Get details for one volume
`hetzner_attach_volume`	Attach a volume to a server	⚠️
`hetzner_detach_volume`	Detach a volume from its server	⚠️

Server Metrics (1)

Tool	Description
`hetzner_get_server_metrics`	CPU, disk I/O, and network metrics — defaults to the last 5 minutes

Server RAM via SSH (1)

Tool	Description
`hetzner_get_server_ram`	SSH into the server and run `free -m` to get RAM and swap usage (the Hetzner Metrics API does not expose memory metrics)

Prerequisites for hetzner_get_server_ram: the server's public IPv4 must be reachable and the SSH private key must be available in the system SSH agent or ~/.ssh/.

Storage Boxes (20) — requires `HETZNER_API_TOKEN_UNIFIED`

Core

Tool	Description	⚠️
`hetzner_list_storage_boxes`	List all Storage Boxes (auto-paginates)
`hetzner_get_storage_box`	Get details for one Storage Box
`hetzner_create_storage_box`	Create a new Storage Box (billed immediately)
`hetzner_update_storage_box`	Update name or labels
`hetzner_delete_storage_box`	Permanently delete a Storage Box	⚠️
`hetzner_change_storage_box_type`	Upgrade or downgrade the Storage Box plan	⚠️
`hetzner_change_storage_box_protection`	Enable or disable delete protection
`hetzner_reset_storage_box_password`	Reset the Storage Box password	⚠️
`hetzner_update_storage_box_access_settings`	Configure SSH / Samba / WebDAV / ZFS / external access

Folders

Tool	Description
`hetzner_list_storage_box_folders`	List folders inside a Storage Box

Subaccounts

Tool	Description	⚠️
`hetzner_list_storage_box_subaccounts`	List subaccounts (auto-paginates)
`hetzner_create_storage_box_subaccount`	Create a subaccount with scoped access
`hetzner_update_storage_box_subaccount`	Update subaccount settings
`hetzner_delete_storage_box_subaccount`	Delete a subaccount	⚠️

Snapshots

Tool	Description	⚠️
`hetzner_list_storage_box_snapshots`	List snapshots (auto-paginates)
`hetzner_create_storage_box_snapshot`	Trigger an on-demand snapshot
`hetzner_delete_storage_box_snapshot`	Delete a snapshot	⚠️
`hetzner_rollback_storage_box_snapshot`	Roll back to a snapshot — overwrites current data	⚠️
`hetzner_enable_storage_box_snapshot_plan`	Enable automatic scheduled snapshots
`hetzner_disable_storage_box_snapshot_plan`	Disable automatic scheduled snapshots

Capabilities and Limitations

This MCP can:

Create, manage, and monitor servers
Manage SSH keys, Cloud Volumes, and Storage Boxes
Report CPU, disk I/O, network, and RAM usage

This MCP cannot:

Create Hetzner projects (do that in the web console)
Manage billing, firewalls, load balancers, floating IPs, or networks
See resources outside the project whose token you provide

⚠️ Creating servers costs real money. Hetzner bills by the hour — a cx22 runs ~~€0.006/hr (~~€4/mo), a cx52 runs ~~€0.119/hr (~~€86/mo). Always delete servers you are not using.

Troubleshooting

HETZNER_API_TOKEN environment variable is required — token is missing from the MCP config env block. Restart Claude Code after adding it.

401 Unauthorized on Storage Box tools — you need a unified token from console.hetzner.com/account/security/api-tokens, not a Cloud project token. Set it as HETZNER_API_TOKEN_UNIFIED.

hetzner_get_server_ram connection error — check that the server is running, port 22 is reachable, and ssh_user (default root) has SSH access via a key loaded in the agent.

Development

bun install
bun run build       # compile TypeScript to dist/
bun run dev         # watch mode
bun run test        # vitest
bun run typecheck   # tsc --noEmit
bun run lint        # eslint --max-warnings=0

To test locally without publishing:

HETZNER_API_TOKEN="your-token" bun dist/index.js

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale

ResponsivenessResponsive

Resources

Need Help?

Related Servers

Related MCP Connectors

CloudPepperOAuth
io.cloudpepper
Manage CloudPepper servers, Odoo instances, backups, and deployments over MCP.
Cloud Platforms CI/CD & DevOps ERP Systems
2
mcp A
com.fadehost
Manage FadeHost game servers, Discord bots and VPS: console, stats, backups, logs, lifecycle.
Games & Gamification Virtualization
231
mcpOAuth
net.hepcloud
Manage HepCloud (Turkish cloud) servers and managed PostgreSQL from your AI assistant. OAuth 2.1.
Cloud Platforms Databases
1
Scalix Cloud A
world.scalix
The agent-native cloud: database, functions, AI, storage, computers. 50 tools, one API key.
Cloud Platforms Databases AI & Machine Learning
5122

Related MCP Servers

Docker/Hetzner MCP Server
Virtualization Networking & Infrastructure Cloud Platforms
optimusbasti
A
license
Not graded
quality
Not graded
maintenance
Provides tools for managing Docker containers, Compose stacks, and system resources on Hetzner servers via SSH. It also includes capabilities for reloading Caddy configurations and managing Cloudflare DNS records.
Updated 6 months ago (2026-03-28 05:34 UTC)
-
Hetzner Cloud MCP Server —
Cloud Platforms Virtualization Shell Access
wbf-solutions
A
license
Not graded
quality
C
maintenance
Open-source MCP server for managing Hetzner Cloud infrastructure with two management layers: * Layer 1 — Hetzner Cloud API (35 tools): Server power control, metrics, snapshots, backups, firewalls, DNS zones and records, rescue mode, server rebuild and rescale. Works even when the server OS is unresponsive. * Layer 2 — SSH (25 tools): Service management (systemd), Nginx config and reload,
Updated 5 months ago (2026-04-12 18:44 UTC)
MIT
mcp-hetzner
Cloud Platforms Networking & Infrastructure Cloud Storage
ginkelsoft-development
A
license
B
quality
D
maintenance
Enables conversational management of Hetzner Cloud, DNS, and Storage Box infrastructure through 137 MCP tools for CRUD operations and actions like server power control, DNS zone management, and storage box snapshots.
Updated 4 months ago (2026-05-26 14:24 UTC)
100
MIT
hetzner-mcp-server
Cloud Platforms Virtualization
nityeshaga
A
license
A
quality
D
maintenance
Enables Claude Code to manage Hetzner Cloud servers, including creating, deleting, powering on/off, and rebooting servers, as well as managing SSH keys and listing resources.
Updated 8 months ago (2026-01-06 19:53 UTC)
14
15 npm
1
MIT

Hetzner MCP Server

Quick Start

Environment Variables

Why two tokens?

Available Tools (40 total)

Servers (7)

SSH Keys (4)

Reference (3)

Cloud Volumes (4)

Server Metrics (1)

Server RAM via SSH (1)

Storage Boxes (20) — requires HETZNER_API_TOKEN_UNIFIED

Core

Folders

Subaccounts

Snapshots

Capabilities and Limitations

Troubleshooting

Development

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Docker/Hetzner MCP Server

Hetzner Cloud MCP Server —

mcp-hetzner

hetzner-mcp-server

Storage Boxes (20) — requires `HETZNER_API_TOKEN_UNIFIED`