
A Model Context Protocol (MCP) server that integrates AI assistants with the Terraform Cloud API
A Model Context Protocol (MCP) server that integrates AI assistants with the Terraform Cloud API, allowing you to manage your infrastructure through natural conversation
·
A Model Context Protocol (MCP) server that integrates AI assistants with the Terraform Cloud API, allowing you to manage your infrastructure through natural conversation. Built with Pydantic models and structured around domain-specific modules, this server is compatible with any MCP-supporting platform including Claude, Claude Code CLI, Claude Desktop, Cursor, Copilot Studio, and others.
READ_ONLY_TOOLS=true for maximum safety in production environmentsuv package manager (recommended) or pipTo use this MCP server, you need a Terraform Cloud (or Terraform Enterprise) API token:
Use this token as your TFC_TOKEN environment variable in the configuration steps below.
For more information about API token types and permissions, see the HCP Terraform API Tokens documentation.
TFC_TOKEN - Terraform Cloud API token (required)TFC_ADDRESS - Terraform Cloud/Enterprise address (optional, defaults to https://app.terraform.io)ENABLE_DELETE_TOOLS - Enable/disable destructive operations (optional, defaults to false)READ_ONLY_TOOLS - Enable only read-only operations (optional, defaults to false)ENABLE_RAW_RESPONSE - Return raw vs filtered responses (optional, defaults to false)# Clone the repository
git clone https://github.com/severity1/terraform-cloud-mcp.git
cd terraform-cloud-mcp
# Create virtual environment and activate it
uv venv
source .venv/bin/activate
# Install package
uv pip install .# Clone the repository
git clone https://github.com/severity1/terraform-cloud-mcp.git
cd terraform-cloud-mcp
# Build the Docker image
docker build -t terraform-cloud-mcp:latest .# Add to Claude Code with your Terraform Cloud token
claude mcp add -e TFC_TOKEN=YOUR_TF_TOKEN -e ENABLE_DELETE_TOOLS=false -s user terraform-cloud-mcp -- "terraform-cloud-mcp"
# To use a self-hosted Terraform Enterprise instance:
# claude mcp add -e TFC_TOKEN=YOUR_TF_TOKEN -e TFC_ADDRESS=https://terraform.example.com -s user terraform-cloud-mcp -- "terraform-cloud-mcp"
# To enable delete operations (use with caution):
# claude mcp add -e TFC_TOKEN=YOUR_TF_TOKEN -e ENABLE_DELETE_TOOLS=true -s user terraform-cloud-mcp -- "terraform-cloud-mcp"Create a claude_desktop_config.json configuration file:
{
"mcpServers": {
"terraform-cloud-mcp": {
"command": "/path/to/uv", # Get this by running: `which uv`
"args": [
"--directory",
"/path/to/your/terraform-cloud-mcp", # Full path to this project
"run",
"terraform-cloud-mcp"
],
"env": {
"TFC_TOKEN": "your_actual_token_here", # replace with actual token
"TFC_ADDRESS": "https://app.terraform.io", # optional, change for self-hosted TFE
"ENABLE_DELETE_TOOLS": "false", # set to "true" to enable destructive operations/tools
"READ_ONLY_TOOLS": "false" # set to "true" to only enable ready-only operations/tools
}
}
}
}{
"mcpServers": {
"terraform-cloud-mcp": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "TFC_TOKEN",
"-e", "TFC_ADDRESS",
"-e", "ENABLE_DELETE_TOOLS",
"-e", "READ_ONLY_TOOLS",
"terraform-cloud-mcp:latest"
],
"env": {
"TFC_TOKEN": "your_actual_token_here",
"TFC_ADDRESS": "https://app.terraform.io",
"ENABLE_DELETE_TOOLS": "false",
"READ_ONLY_TOOLS": "false"
}
}
}
}Replace your_terraform_cloud_token with your actual Terraform Cloud API token.
For other platforms (like Cursor, Copilot Studio, or Glama), follow their platform-specific instructions for adding an MCP server. Most platforms require:
TFC_TOKEN).TFC_ADDRESS).ENABLE_DELETE_TOOLS=true for destructive operations).READ_ONLY_TOOLS=true to disable all write operations).Note: When READ_ONLY_TOOLS=true, all create, update, delete, apply, and state modification operations are disabled. Only read operations (list, get, view) remain available.
get_account_details(): Gets account information for the authenticated user or service account.list_workspaces(organization, page_number, page_size, search): List and filter workspaces.get_workspace_details(workspace_id, organization, workspace_name): Get detailed information about a specific workspace.create_workspace(organization, name, params): Create a new workspace with optional parameters.update_workspace(organization, workspace_name, params): Update an existing workspace's configuration.delete_workspace(organization, workspace_name): Delete a workspace and all its content.safe_delete_workspace(organization, workspace_name): Delete only if the workspace isn't managing any resources.Note: Delete operations are disabled by default for safety. Set ENABLE_DELETE_TOOLS=true to enable these destructive operations.
lock_workspace(workspace_id, reason): Lock a workspace to prevent runs.unlock_workspace(workspace_id): Unlock a workspace to allow runs.force_unlock_workspace(workspace_id): Force unlock a workspace locked by another user.create_run(workspace_id, params): Create and queue a Terraform run in a workspace using its ID.list_runs_in_workspace(workspace_id, ...): List and filter runs in a specific workspace using its ID.list_runs_in_organization(organization, ...): List and filter runs across an entire organization.get_run_details(run_id): Get detailed information about a specific run.apply_run(run_id, comment): Apply a run waiting for confirmation.discard_run(run_id, comment): Discard a run waiting for confirmation.cancel_run(run_id, comment): Cancel a run currently planning or applying.force_cancel_run(run_id, comment): Forcefully cancel a run immediately.force_execute_run(run_id): Forcefully execute a pending run by canceling prior runs.get_plan_details(plan_id): Get detailed information about a specific plan.get_plan_json_output(plan_id): Retrieve the JSON execution plan for a specific plan with proper redirect handling.get_run_plan_json_output(run_id): Retrieve the JSON execution plan from a run with proper redirect handling.get_plan_logs(plan_id): Retrieve logs from a plan operation.get_apply_details(apply_id): Get detailed information about a specific apply.get_errored_state(apply_id): Retrieve the errored state from a failed apply for recovery.get_apply_logs(apply_id): Retrieve logs from an apply operation.create_project(organization, name, params): Create a new project with optional parameters.update_project(project_id, params): Update an existing project's configuration.list_projects(organization, ...): List and filter projects in an organization.get_project_details(project_id): Get detailed information about a specific project.delete_project(project_id): Delete a project (fails if it contains workspaces). Requires ENABLE_DELETE_TOOLS=truelist_project_tag_bindings(project_id): List tags bound to a project.add_update_project_tag_bindings(project_id, tag_bindings): Add or update tag bindings on a project.move_workspaces_to_project(project_id, workspace_ids): Move workspaces into a project.get_organization_details(organization): Get detailed information about a specific organization.get_organization_entitlements(organization): Show entitlement set for organization features.list_organizations(page_number, page_size, query, query_email, query_name): List and filter organizations.create_organization(name, email, params): Create a new organization with optional parameters.update_organization(organization, params): Update an existing organization's settings.delete_organization(organization): Delete an organization and all its content. Requires ENABLE_DELETE_TOOLS=trueget_cost_estimate_details(cost_estimate_id): Get detailed information about a specific cost estimate, including resource counts (matched and unmatched), prior monthly cost, proposed monthly cost, and delta monthly cost estimations. Use run relationships to find cost estimate IDs for specific runs.get_assessment_result_details(assessment_result_id): Get detailed information about a specific health assessment result.get_assessment_json_output(assessment_result_id): Retrieve the JSON execution plan from an assessment result.get_assessment_json_schema(assessment_result_id): Retrieve the JSON schema file from an assessment result.get_assessment_log_output(assessment_result_id): Retrieve logs from an assessment result operation.list_state_versions(organization, workspace_name, page_number, page_size, filter_status): List and filter state versions in a workspace.get_current_state_version(workspace_id): Get the current state version for a workspace.get_state_version(state_version_id): Get details for a specific state version.create_state_version(workspace_id, serial, md5, params): Create a new state version in a workspace.download_state_file(state_version_id, json_format): Download the raw or JSON formatted state file.list_state_version_outputs(state_version_id, page_number, page_size): List outputs for a specific state version.get_state_version_output(state_version_output_id): Get details for a specific state version output.list_workspace_variables(workspace_id): List all variables (Terraform and environment) for a workspace.create_workspace_variable(workspace_id, key, category, params): Create a new variable in a workspace.update_workspace_variable(workspace_id, variable_id, params): Update an existing workspace variable.delete_workspace_variable(workspace_id, variable_id): Delete a workspace variable. Requires ENABLE_DELETE_TOOLS=truelist_variable_sets(organization, page_number, page_size): List variable sets in an organization.get_variable_set(varset_id): Get details for a specific variable set.create_variable_set(organization, name, params): Create a new variable set.update_variable_set(varset_id, params): Update an existing variable set.delete_variable_set(varset_id): Delete a variable set and all its variables. Requires ENABLE_DELETE_TOOLS=trueassign_variable_set_to_workspaces(varset_id, workspace_ids): Assign a variable set to workspaces.unassign_variable_set_from_workspaces(varset_id, workspace_ids): Remove a variable set from workspaces.assign_variable_set_to_projects(varset_id, project_ids): Assign a variable set to projects.unassign_variable_set_from_projects(varset_id, project_ids): Remove a variable set from projects.list_variables_in_variable_set(varset_id): List all variables in a variable set.create_variable_in_variable_set(varset_id, key, category, params): Create a variable in a variable set.update_variable_in_variable_set(varset_id, var_id, params): Update a variable in a variable set.delete_variable_from_variable_set(varset_id, var_id): Delete a variable from a variable set. Requires ENABLE_DELETE_TOOLS=trueNote: Variable management includes both Terraform input variables and environment variables. Sensitive variables have their values hidden for security. Delete operations are disabled by default and require ENABLE_DELETE_TOOLS=true.
For detailed development guidance including code standards, Pydantic patterns, and contribution workflows, see our Development Documentation.
# Clone the repository
git clone https://github.com/severity1/terraform-cloud-mcp.git
cd terraform-cloud-mcp
# Create virtual environment and activate it
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
# Install in development mode with development dependencies
uv pip install -e .
uv pip install black mypy pydantic ruff# Run the server in development mode
mcp dev terraform_cloud_mcp/server.py
# Run tests and quality checks
uv run -m mypy .
uv run -m ruff check .
uv run -m black .For detailed information on code organization, architecture, development workflows, and code quality guidelines, refer to docs/DEVELOPMENT.md.
The codebase includes comprehensive documentation:
docs/ directory contains detailed examples for each domain:
docs/FILTERING_SYSTEM.md: Comprehensive guide to the audit-safe response filtering system (5-15% token reduction, 100% audit compliance)docs/DEVELOPMENT.md: Development standards and coding guidelines with references to actual codedocs/API_REFERENCES.md: Terraform Cloud API documentation links with implementation statusdocs/CONTRIBUTING.md: Guidelines for contributing to the projectdocs/models/: Reference documentation for all model typesdocs/tools/: Detailed reference documentation for each tooldocs/conversations/: Sample conversation flows with the APIserver.py:
import logging
logging.basicConfig(level=logging.DEBUG)Contributions are welcome! Please open an issue or pull request if you'd like to contribute to this project.
See our Contributing Guide for detailed instructions on how to get started, code quality standards, and the pull request process.
This project is not affiliated with, associated with, or endorsed by HashiCorp or Terraform. "Terraform" and "Terraform Cloud" are trademarks of HashiCorp. This project merely interacts with the Terraform Cloud public API under fair use.
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add terraform-cloud-mcp -- docker run -i --rm -e TFC_TOKEN -e TFC_ADDRESS -e ENABLE_DELETE_TOOLS -e READ_ONLY_TOOLS terraform-cloud-mcp:latest{
"mcpServers": {
"terraform-cloud-mcp": {
"env": {
"TFC_TOKEN": "",
"TFC_ADDRESS": "",
"READ_ONLY_TOOLS": "",
"ENABLE_DELETE_TOOLS": ""
},
"args": [
"run",
"-i",
"--rm",
"-e",
"TFC_TOKEN",
"-e",
"TFC_ADDRESS",
"-e",
"ENABLE_DELETE_TOOLS",
"-e",
"READ_ONLY_TOOLS",
"terraform-cloud-mcp:latest"
],
"command": "docker"
}
}
}code --add-mcp '{"name":"terraform-cloud-mcp","env":{"TFC_TOKEN":"","TFC_ADDRESS":"","READ_ONLY_TOOLS":"","ENABLE_DELETE_TOOLS":""},"args":["run","-i","--rm","-e","TFC_TOKEN","-e","TFC_ADDRESS","-e","ENABLE_DELETE_TOOLS","-e","READ_ONLY_TOOLS","terraform-cloud-mcp:latest"],"command":"docker"}'[mcp_servers.terraform-cloud-mcp]
command = "docker"
args = ["run", "-i", "--rm", "-e", "TFC_TOKEN", "-e", "TFC_ADDRESS", "-e", "ENABLE_DELETE_TOOLS", "-e", "READ_ONLY_TOOLS", "terraform-cloud-mcp:latest"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/terraform-cloud-mcp-server to learn what the "Terraform Cloud MCP Server" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add -e TFC_TOKEN=YOUR_TF_TOKEN -e ENABLE_DELETE_TOOLS=false -s user terraform-cloud-mcp -- "terraform-cloud-mcp"This server runs locally, so we can't read its tool list over the web yet.
We could not run this server: it ships no npx package for our sandbox and no public endpoint. The four checks that need a live server are left out, and the grade tops out at B until one exists.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/terraform-cloud-mcp-server)Nothing comparable is listed yet.
v0.8.20Release notesv0.8.19Release notesv0.8.18Release notesv0.8.17Release notesv0.8.16Release notesv0.8.15Release notesv0.8.14Release notesv0.8.13Release notesv0.8.12Release notesv0.8.11Release notesv0.8.10Release notesv0.8.9Release notesv0.8.8Release notesv0.8.7Release notesv0.8.6Release notesv0.8.5Release notesv0.8.4Release notesv0.8.3Release notesv0.8.2Release notesv0.8.1Release notesConnect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "terraform-cloud-mcp-server" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.