Connect Terraform to Your AI Agent

Use AI with HCP Terraform to inspect organizations, workspaces and existing infrastructure run records.

8 tools API key

Try a Terraform Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Terraform

Review Workspaces

List workspaces and retrieve a selected workspace.

/oo Terraform: List workspaces in organization [name], then get workspace [ID] and summarize settings.

Review Infrastructure Runs

List workspace runs and inspect a selected run.

/oo Terraform: List runs for workspace [ID], get run [ID] and explain its returned state.

Start Working with Terraform

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Terraform

    Provide an HCP Terraform API token.

    Connect Terraform →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Token access to the target organizations and workspaces.
  • Use organization names, workspace IDs and run IDs. Inspecting a run does not apply an infrastructure change.

Terraform Tools

Use AI with HCP Terraform to inspect organizations, workspaces and existing infrastructure run records.

Review Workspaces

List workspaces and retrieve a selected workspace.

Review Infrastructure Runs

List workspace runs and inspect a selected run.

8 tools

Get Account Details

Get details for the user or service user associated with the Terraform API token.

terraform.get_account_details

List Organizations

List HCP Terraform organizations visible to the authenticated token.

terraform.list_organizations

Get Organization

Get details for a single HCP Terraform organization by name.

terraform.get_organization

List Workspaces

List HCP Terraform workspaces in an organization with optional pagination.

terraform.list_workspaces

Get Workspace By Id

Get HCP Terraform workspace details by workspace ID.

terraform.get_workspace_by_id

Get Workspace By Name

Get HCP Terraform workspace details by organization and workspace name.

terraform.get_workspace_by_name

List Workspace Runs

List HCP Terraform runs for a workspace with optional filters.

terraform.list_workspace_runs

Get Run

Get HCP Terraform run details by run ID.

terraform.get_run

Frequently Asked Questions

Does reading a run apply it?

No. These actions inspect existing run records.

Can I locate a workspace by name?

get_workspace_by_name accepts organization and workspace names.

What should I specify in my request?

Use organization names, workspace IDs and run IDs. Inspecting a run does not apply an infrastructure change.

Connect Terraform

About Terraform ↗