create_project

create_project

Create and organize Terraform Cloud projects to group workspaces, manage settings, and apply permissions. Define project details, auto-destroy duration, and tag bindings for efficient infrastructure management.

Instructions

Create a new project in an organization.

Creates a new Terraform Cloud project which serves as a container for workspaces. Projects help organize workspaces into logical groups and can have their own settings and permissions.

API endpoint: POST /organizations/{organization}/projects

Args: organization: The name of the organization name: The name to give the project params: Additional project parameters (optional): - description: Human-readable description of the project - auto_destroy_activity_duration: How long each workspace should wait before auto-destroying (e.g., '14d', '24h') - tag_bindings: List of tag key-value pairs to bind to the project

Returns: The created project data including configuration, settings and metadata

See: docs/tools/project.md for reference documentation

Input Schema

Name	Required	Description	Default
`name`	Yes
`organization`	Yes
`params`	No

Input Schema (JSON Schema)

{
  "$defs": {
    "ProjectParams": {
      "description": "Parameters for project operations without routing fields.\n\nThis model provides all optional parameters for creating or updating projects,\nreusing field definitions from BaseProjectRequest. It separates configuration\nparameters from routing information like organization and project ID.\n\nReference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/projects\n\nNote:\n    When updating a project, use this model to specify only the attributes\n    you want to change. Unspecified attributes retain their current values.\n    All fields are inherited from BaseProjectRequest.\n\nSee:\n    docs/models/project.md for reference",
      "properties": {
        "auto-destroy-activity-duration": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "How long each workspace should wait before auto-destroying (e.g., '14d', '24h')",
          "title": "Auto-Destroy-Activity-Duration"
        },
        "description": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Description of the project",
          "title": "Description"
        },
        "name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Name of the project",
          "title": "Name"
        },
        "tag-bindings": {
          "anyOf": [
            {
              "items": {
                "$ref": "#/$defs/TagBinding"
              },
              "type": "array"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "Tags to bind to the project, inherited by workspaces",
          "title": "Tag-Bindings"
        }
      },
      "title": "ProjectParams",
      "type": "object"
    },
    "TagBinding": {
      "description": "Tag binding configuration for a project.\n\nDefines a tag key-value pair that can be bound to a project\nand inherited by its workspaces.\n\nReference: https://developer.hashicorp.com/terraform/cloud-docs/api-docs/projects\n\nSee:\n    docs/models/project.md for reference",
      "properties": {
        "key": {
          "description": "The key of the tag",
          "title": "Key",
          "type": "string"
        },
        "value": {
          "description": "The value of the tag",
          "title": "Value",
          "type": "string"
        }
      },
      "required": [
        "key",
        "value"
      ],
      "title": "TagBinding",
      "type": "object"
    }
  },
  "properties": {
    "name": {
      "title": "Name",
      "type": "string"
    },
    "organization": {
      "title": "Organization",
      "type": "string"
    },
    "params": {
      "anyOf": [
        {
          "$ref": "#/$defs/ProjectParams"
        },
        {
          "type": "null"
        }
      ],
      "default": null,
      "title": "Params"
    }
  },
  "required": [
    "organization",
    "name"
  ],
  "type": "object"
}

terraform-cloud-mcp

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from terraform-cloud-mcp

Related Tools

MCP directory API