terraform-workspaces

Manage HCP Terraform workspaces, runs, and variables via the terraform-mcp server.

650|182|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/automateyournetwork/netclaw --skill terraform-workspaces
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: terraform-workspaces
Source: https://github.com/automateyournetwork/netclaw/tree/main/workspace/skills/terraform-workspaces
Command: npx skills add https://github.com/automateyournetwork/netclaw --skill terraform-workspaces

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Managing Terraform Cloud or Terraform Enterprise workspaces manually through the web UI is slow and error-prone, especially when tracking run statuses, variables, and configurations across many workspaces and organizations.

Core Features & Use Cases

  • Workspace Lifecycle Management: List, inspect, create, update, and delete workspaces in any HCP Terraform organization.
  • Run Operations: Trigger Terraform runs, list run history, check run status, and cancel pending runs.
  • Variable Inspection: Retrieve workspace details including configured variables for auditing and troubleshooting.
  • Use Case: A platform engineer needs to verify why a deployment stalled. They ask for the status of the last run on the prod-vpc workspace, review the variables, and trigger a fresh plan on the dev-network workspace — all through natural language.

Quick Start

List all workspaces in the network-infra organization and show the status of the last run for the prod-vpc workspace.

Frequently Asked Questions about terraform-workspaces

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trigger a Terraform run on a workspace?

Use the trigger_run tool with the target workspace name to start a new Terraform run. You can then poll get_run_status to monitor progress or use cancel_run to stop a pending run.

How to list workspaces in a Terraform Cloud organization?

Call list_workspaces with the organization name to retrieve all workspaces. You can then use get_workspace on any result to view its detailed configuration and variables.

Does this work with self-hosted Terraform Enterprise?

Yes, self-hosted Terraform Enterprise is supported by setting the TFE_ADDRESS environment variable to your instance URL. A TFE_TOKEN API token is required in both cloud and self-hosted setups.

What credentials are required for HCP Terraform workspace management?

A TFE_TOKEN environment variable containing a valid HCP Terraform API token is required. For self-hosted Terraform Enterprise, also set TFE_ADDRESS to point at your instance.

Can I see what variables are set on a Terraform workspace?

Yes, the get_workspace tool returns workspace details including configured variables. This is useful for auditing settings before triggering a run or troubleshooting configuration drift.