Skip to main content

Terraform Cloud

Where to apply for a Terraform Cloud (HCP) API token and how to connect it to Nora.
Terraform Cloud (now HCP Terraform) integrations let your agents read workspaces, queue runs, and inspect state versions. Nora authenticates with a user/team API token — Bearer auth with the JSON:API content type.

Where to apply for credentials

User-level tokens come from your Terraform Cloud account settings: For team-scoped permissions, use a team token (Settings → Teams → Choose team → API tokens) so the agent operates within a single team’s permissions instead of the user’s.

Connect in Nora

1

Open the Terraform integration

From an agent’s detail page, open the Integrations tab and find Terraform in the catalog.
2

Paste the token

Paste the API token into the API Token field.
3

(Optional) Enter the organization

Set the Organization field to the organization slug (e.g. acme-eng) so the agent doesn’t have to specify it on every call.
4

Connect

Click Connect. Nora encrypts the token and calls GET https://app.terraform.io/api/v2/account/details to verify it. The card shows your Terraform Cloud username on success.

Verify the connection

The Test button calls /api/v2/account/details. Failures usually mean the token was revoked from the same page where it was issued.

MCP server

There’s no official Terraform MCP server published by HashiCorp yet. Community servers exist on npm — none have stabilized.

Environment variables Nora injects

VariableSource
TFE_TOKENAPI Token field
TFE_ORGANIZATIONOrganization (if set)