list_workspaces

Discover and filter Terraform Cloud workspaces in an organization. Retrieve paginated lists, search by name, and access workspace configurations for management and review.

Instructions

List workspaces in an organization.

Retrieves a paginated list of all workspaces in a Terraform Cloud organization.
Results can be filtered using a search string to find specific workspaces by name.
Use this tool to discover existing workspaces, check workspace configurations,
or find specific workspaces by partial name match.

API endpoint: GET /organizations/{organization}/workspaces

Args:
    organization: The name of the organization to list workspaces from
    page_number: The page number to return (default: 1)
    page_size: The number of items per page (default: 20, max: 100)
    search: Optional search string to filter workspaces by name

Returns:
    Paginated list of workspaces with their configuration settings and metadata

See:
    docs/tools/workspace_tools.md for usage examples

Input Schema

Name	Required	Description	Default
`organization`	Yes
`page_number`	No
`page_size`	No
`search`	No

Input Schema (JSON Schema)

{
  "properties": {
    "organization": {
      "title": "Organization",
      "type": "string"
    },
    "page_number": {
      "default": 1,
      "title": "Page Number",
      "type": "integer"
    },
    "page_size": {
      "default": 20,
      "title": "Page Size",
      "type": "integer"
    },
    "search": {
      "default": "",
      "title": "Search",
      "type": "string"
    }
  },
  "required": [
    "organization"
  ],
  "title": "list_workspacesArguments",
  "type": "object"
}

terraform-cloud-mcp

list_workspaces

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools

MCP directory API