Add it to Claude Code
claude mcp add -e "HCLOUD_TOKEN=${HCLOUD_TOKEN}" hetzner-mcp -- node dist/index.jsHCLOUD_TOKENMake your agent remember this setup
hetzner-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Full lifecycle management for servers, load balancers, and volumes
- Network and subnet configuration for private networking
- Firewall, Floating IP, and Primary IP management
- SSH key and placement group CRUD operations
- Real-time infrastructure pricing and action status polling
Tools 5
server_managementCreate, delete, power on/off, reboot, and resize serversload_balancer_managementFull CRUD operations for load balancers and target managementnetwork_managementCreate and delete networks and subnetsvolume_managementCreate, attach, detach, and delete block storage volumesfirewall_managementCreate, update, and delete firewallsEnvironment Variables
HCLOUD_TOKENrequiredYour Hetzner Cloud API tokenTry it
Original README from Xodus-CO/hetzner-mcp
Hetzner MCP
A Cursor Plugin for the Cursor Plugin marketplace. Manage Hetzner Cloud resources directly from Cursor using natural language and AI-powered workflows.
Get Hetzner Cloud — new signups get €20 credit.
Features
- Servers: Create, delete, power on/off, reboot, resize; attach to networks and ISOs
- Load Balancers: Full CRUD, add/remove targets and services;
list_load_balancer_typesfor creation - Networks: Create/delete networks; add/delete subnets (e.g. 10.0.0.0/16 per zone for private networking)
- Volumes: Create, attach, detach, delete block storage
- Firewalls: Create, update, delete firewalls
- Floating IPs: Create, assign, unassign, delete
- Primary IPs: Create, assign, unassign, delete (datacenter-scoped static IPs; server must be off to assign/unassign)
- SSH Keys: Full CRUD
- Placement Groups: Full CRUD for anti-affinity groups
- Metadata & actions: Locations, images, server types, load balancer types, datacenters;
list_actions/get_actionto poll create/delete results
All operations work through natural language in Cursor's AI agent.
Installation
Install the plugin from the Cursor Plugin marketplace, then set your Hetzner API token: in Cursor Settings → Features → Model Context Protocol, find the hetzner-cloud server and set HCLOUD_TOKEN in its environment.
Usage
Ask Cursor's agent to manage your Hetzner infrastructure:
Simple
- "List my servers in Nuremberg"
- "Create a cx22 server with Ubuntu 24.04"
- "Attach a 10GB volume to web-01"
- "Set up a load balancer for my web servers"
- "Show current pricing for cpx31 servers"
Complex
- "Create a private network 10.0.0.0/16 in eu-central, add a subnet, then create two servers in that zone (e.g. fsn1 and nbg1) and attach them"
- "Create a firewall for SSH and HTTP, attach to my web servers, then create a load balancer and add those servers as targets"
- "List running actions and get status of action 12345"
- "Create a Primary IP in ash-dc1, power off web-01, assign the IP, power back on"
- "Tear down: detach/delete volumes, delete LB and firewall, unassign/delete floating IPs, delete servers web-01 and web-02"
Configuration
Set HCLOUD_TOKEN in your environment or configure in plugins/hetzner-mcp/mcp.json:
{
"mcpServers": {
"hetzner-cloud": {
"command": "node",
"args": ["dist/index.js"],
"env": {
"HCLOUD_TOKEN": "your_token_here"
}
}
}
}
Development
- Source:
plugins/hetzner-mcp/src/ - Build:
npm run build - Validate:
npm run validate
See plugins/hetzner-mcp/README.md for detailed documentation.
License
MIT