# Hetzner Cloud (unofficial)

> Hetzner Cloud (unofficial) is an open-source MCP server for cloud and infrastructure. Typed tools for the Hetzner Cloud API, with read-only, confirm and deny switches. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI
- **Repository:** https://github.com/mguttmann/the-real-hetzner-mcp
- **MCP Registry name:** io.github.mguttmann/the-real-hetzner-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

Rather than a few hand-picked commands, this server generates one typed tool per operation in Hetzner's Cloud API specification, then adds tuned wrappers for common server tasks. Cloud DNS zones and record sets are covered; Hetzner Robot, the standalone DNS product and Storage Boxes are not.

The server can do exactly what your API token allows, so the safeguards matter. HETZNER_READ_ONLY blocks every write, HETZNER_CONFIRM_WRITES returns a preview unless the call carries a confirm value, and HETZNER_DENY_TOOLS blocks tools by name pattern. Because hcloud_raw_request can reach any endpoint, it should be denied too if you deny others. Requests have capped 429 backoff, automatic pagination and action polling with a time budget.

It is unofficial and unaffiliated with Hetzner, maintained by one person on a best-effort basis. The README warns against versions below 0.2.0, which had a path-injection flaw.

## Features

- **Full API coverage:** One generated tool per Cloud API operation, read and write.
- **Read-only switch:** Optionally blocks every tool that changes anything.
- **Write confirmation:** Optionally returns a preview until a call carries confirmation.
- **Deny patterns:** Blocks tools by name glob.
- **Raw request tool:** Escape hatch for any endpoint.
- **Resilient calls:** Capped backoff on rate limits, pagination and action polling.

## Good for

- List and inspect servers in a Hetzner project
- Create or resize a server from chat
- Manage Cloud DNS records
- Give a team read-only infrastructure visibility

## Install

### Claude Code (Terminal)

```sh
claude mcp add the-real-hetzner-mcp --env HETZNER_API_TOKEN='<HETZNER_API_TOKEN>' -- npx -y @mguttmann/hetzner-cloud-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "the-real-hetzner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mguttmann/hetzner-cloud-mcp"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "the-real-hetzner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mguttmann/hetzner-cloud-mcp"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "the-real-hetzner-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mguttmann/hetzner-cloud-mcp"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "the-real-hetzner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mguttmann/hetzner-cloud-mcp"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "the-real-hetzner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@mguttmann/hetzner-cloud-mcp"
      ],
      "env": {
        "HETZNER_API_TOKEN": "<HETZNER_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `hcloud_raw_request`: Sends a request to any Hetzner Cloud API endpoint.

## FAQ

### Is it official?

No. It is unaffiliated with Hetzner and its README says so.

### How do I keep it from changing anything?

Set HETZNER_READ_ONLY=true, or use a read-only API token.

### Which versions should I avoid?

0.1.x. The README says they have a path-injection vulnerability fixed in 0.2.0.

### What does it need?

Node.js 22.12 or newer and a Hetzner Cloud API token.

### Is Hetzner Cloud (unofficial) free?

Yes. Hetzner Cloud (unofficial) is open source, so you can use and self-host it for free.

### How do I add Hetzner Cloud (unofficial) to Claude Code?

Run this command in your terminal: claude mcp add the-real-hetzner-mcp --env HETZNER_API_TOKEN='<HETZNER_API_TOKEN>' -- npx -y @mguttmann/hetzner-cloud-mcp

### What are the best alternatives to Hetzner Cloud (unofficial)?

The closest alternatives to Hetzner Cloud (unofficial) are mcp, Webflow, Ripe Stat, Vercel MCP and OpenWrt MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [Webflow](https://ai-powered.com/mcp/webflow): Webflow is a freemium MCP server for cloud and infrastructure.
- [Ripe Stat](https://ai-powered.com/mcp/ripe-stat): Ripe Stat is a freemium MCP server for cloud and infrastructure.
- [Vercel MCP](https://ai-powered.com/mcp/vercel-mcp): Vercel MCP is an MCP server for cloud and infrastructure.
- [OpenWrt MCP](https://ai-powered.com/mcp/openwrt-mcp): OpenWrt MCP is an open-source MCP server for cloud and infrastructure.
- [Opendatasoft](https://ai-powered.com/mcp/opendatasoft): Opendatasoft is a freemium MCP server for cloud and infrastructure.
- [Nist Beacon](https://ai-powered.com/mcp/nist-beacon): Nist Beacon is a freemium MCP server for cloud and infrastructure.
- [Gateway SSH](https://ai-powered.com/mcp/gateway-ssh): Gateway SSH is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/hetzner-cloud-unofficial
