Terraform MCP Server

This page documents HashiCorp's official Terraform MCP server: hashicorp/terraform-mcp-server. It connects MCP clients to the public Terraform Registry and to HCP Terraform / Terraform Enterprise APIs.

Use it to look up provider, module, and policy documentation, and to inspect or manage HCP Terraform workspaces and runs.

What it Does

• Registry search: Find provider, module, and Sentinel policy documentation
• Provider details: Retrieve resource, data source, and function documentation, capabilities, and latest versions
• Module details: Retrieve inputs, outputs, examples, submodules, and latest versions
• HCP Terraform workspaces: List and inspect workspaces
• Runs and plans: List runs, inspect plan details, logs, and JSON output, and act on runs

Installation

The upstream project publishes the Docker image hashicorp/terraform-mcp-server.

# Docker (stdio)
docker run -i --rm -e TFE_TOKEN=YOUR_TOKEN hashicorp/terraform-mcp-server:1.3.0

Configuration

{
  "mcpServers": {
    "terraform": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TFE_TOKEN=YOUR_TOKEN",
        "hashicorp/terraform-mcp-server:1.3.0"
      ]
    }
  }
}

For HCP Terraform or Terraform Enterprise, also pass -e TFE_ADDRESS=https://app.terraform.io (or your TFE address). Add -e ENABLE_TF_OPERATIONS=true to enable destructive tools. To limit the tool surface, append --toolsets=registry or --tools=<names> after the image name.

Available Tools

The full tool list is in the Terraform MCP server reference.

Common Workflows

Finding Provider Documentation

1. Search providers for the service you are configuring
2. Retrieve the full documentation for the relevant resource or data source
3. Check the provider's capabilities and latest version
4. Ask for a configuration example based on the returned documentation

Finding and Inspecting a Module

1. Search modules by name or functionality
2. Get module details for inputs, outputs, and examples
3. Retrieve the latest module version
4. Ask for a usage example based on the module documentation

Inspecting Runs and Plans

1. List workspaces to find the target workspace
2. List runs for that workspace
3. Retrieve plan details, plan logs, or the plan JSON output
4. Use action_run only when ENABLE_TF_OPERATIONS=true is set

Example Prompts

• "Find the documentation for the AWS S3 bucket resource"
• "Show me modules for deploying a Kubernetes cluster on AWS"
• "What Sentinel policies are available for enforcing tagging?"
• "List my HCP Terraform workspaces"
• "Show the plan JSON output for the latest run in staging"

Troubleshooting

Supported Providers

The registry tools query the public Terraform Registry, so they cover providers and modules published there, including AWS, Azure, Google Cloud, Kubernetes, and others. The HCP Terraform tools operate on workspaces and runs in your organization.

Sources

• https://github.com/hashicorp/terraform-mcp-server
• https://developer.hashicorp.com/terraform/docs/tools/mcp-server/reference