Hetzner Cloud

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from HCLOUD_TOKEN is sent as the Bearer prefixed Authorization header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
HCLOUD_TOKENYesHetzner Cloud API token (per project, created in Console under Security > API tokens); same env var used by hcloud CLI and Terraform Docs.

Setup

  1. Get a Hetzner Cloud account: Sign up at https://www.hetzner.com/cloud and create a project in the Cloud Console (https://console.hetzner.cloud).
  2. Generate an API token: In the Cloud Console open your project, go to Security > API tokens, and generate a token with Read & Write permissions (Read-only suffices if you skip the write tools).
  3. Set the environment variable: Copy the token into your .env as HCLOUD_TOKEN - it is shown only once at creation time.
  4. Verify access: Run List Servers and List Server Types to confirm the token works.

Provider notes

  • API tokens are scoped to a single Hetzner Cloud project
  • Rate limit applies per token (check RateLimit-* response headers)
  • Power Off is a hard power cut - prefer a graceful OS shutdown for running workloads
  • Creating servers provisions billable infrastructure - confirm server type and location before running write tools

Provider API reference.

Tools

ToolAccessDescription
List Servers<br /><code className="reference-identifier">hetzner__list_servers</code>ReadList servers
Get Server<br /><code className="reference-identifier">hetzner__get_server</code>ReadGet server
Create Server<br /><code className="reference-identifier">hetzner__create_server</code>WriteCreate billable server
Power On Server<br /><code className="reference-identifier">hetzner__power_on_server</code>WritePower on server
Power Off Server<br /><code className="reference-identifier">hetzner__power_off_server</code>WriteHard power off server
List Images<br /><code className="reference-identifier">hetzner__list_images</code>ReadList images
List Server Types<br /><code className="reference-identifier">hetzner__list_server_types</code>ReadList server types
Shutdown Server<br /><code className="reference-identifier">hetzner__shutdown_server</code>WriteGracefully shut down server
Reboot Server<br /><code className="reference-identifier">hetzner__reboot_server</code>WriteGracefully reboot server
List SSH Keys<br /><code className="reference-identifier">hetzner__list_ssh_keys</code>ReadList SSH keys

Verify the connection

Call a read tool such as hetzner__list_servers with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.