HashiCorp · Gemini CLI

Add the Terraform MCP server to Gemini CLI

Look up providers and modules in the Terraform Registry and work with HCP Terraform workspaces.

Official serverLocalCloud & infrastructure

1. Add the server

Run in your terminal

gemini mcp add terraform docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.0.0

2. Sign in

Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server. Terraform runs locally; set any credentials HashiCorp asks for before starting Gemini CLI.

3. Try it

Ask Gemini CLI for something Terraform can do. Look up providers and modules in the Terraform Registry and work with HCP Terraform workspaces. Approve the first tool call and check the result before allowing write actions automatically.

  • · In settings.json, streamable HTTP servers use httpUrl, SSE servers use url, local servers use command.
  • · includeTools and excludeTools limit which tools the model sees.

FAQ

How do I add the Terraform MCP server to Gemini CLI?
Run: gemini mcp add terraform docker run -i --rm docker.io/hashicorp/terraform-mcp-server:1.0.0. Run /mcp auth <name> inside Gemini CLI to sign in to an OAuth server.
Is this the official Terraform MCP server?
Yes. It is published by HashiCorp as io.github.hashicorp/terraform-mcp-server in the official MCP registry.
Does the Terraform MCP server need an API key?
It runs locally from a package. See HashiCorp's docs for any credentials it needs.

Links

Terraform in other clients

More cloud & infrastructure for Gemini CLI

Work at HashiCorp?

Feature Terraform across the directory and its category from $49/month.

Feature this server

Reviewed Oct 5, 2026. Command generated from the registry record and checked against Gemini CLI's documented syntax.