Skip to content

Variables

Project and group CI/CD variable CRUD.

Feature toggle

Opt-in. Enable via GITLAB_TOOLSETS=variables (or GITLAB_TOOLSETS=all), list individual tools in GITLAB_TOOLS=, or activate at runtime with the discover_tools MCP tool.

Tools in this group

list_project_variables

📖 Read-only

List CI/CD variables for a project. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
project_id string ✓ Project ID or URL-encoded path
filter object Filter by environment scope (e.g. '*', 'production')
page number Page number for pagination (default: 1)
per_page number Number of items per page (max: 100, default: 20)

get_project_variable

📖 Read-only

Get a single CI/CD variable from a project. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
project_id string ✓ Project ID or URL-encoded path
key string ✓ The key of the variable
filter object Filter by environment scope

create_project_variable

✏️ Writes

Create a CI/CD variable for a project. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
project_id string ✓ Project ID or URL-encoded path
key string ✓ The key of the variable (must match /[a-zA-Z0-9_]+/)
value string ✓ The value of the variable
variable_type enum (env_var | file) The type of variable: 'env_var' (default) or 'file'
protected boolean Whether the variable is only available on protected branches/tags
masked boolean Whether the variable value is masked in job logs
raw boolean Whether the variable is not expanded (treated as raw string)
environment_scope string Environment scope (e.g. '', 'production'). Default: ''
description string Description of the variable

update_project_variable

✏️ Writes

Update an existing CI/CD variable in a project. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
project_id string ✓ Project ID or URL-encoded path
key string ✓ The key of the variable to update
value string ✓ The new value of the variable
variable_type enum (env_var | file) The type of variable
protected boolean Whether the variable is protected
masked boolean Whether the variable value is masked in job logs
raw boolean Whether the variable is not expanded
environment_scope string New environment scope to assign to the variable (renames the scope, e.g. '*', 'production'). Use filter.environment_scope to identify which variable to update when multiple share the same key.
description string Description of the variable
filter object Identifies which variable to update when multiple variables share the same key across different environment scopes

delete_project_variable

✏️ Writes

Delete a CI/CD variable from a project. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
project_id string ✓ Project ID or URL-encoded path
key string ✓ The key of the variable to delete
filter object Filter by environment scope to disambiguate when multiple variables share the same key

list_group_variables

📖 Read-only

List CI/CD variables for a group. Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
group_id string ✓ Group ID or URL-encoded path
filter object Filter by environment scope (e.g. '*', 'production')
page number Page number for pagination (default: 1)
per_page number Number of items per page (max: 100, default: 20)

get_group_variable

📖 Read-only

Get a single CI/CD variable from a group. Use this for a known resource or result; choose the corresponding list or search tool when you need to discover multiple resources. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
group_id string ✓ Group ID or URL-encoded path
key string ✓ The key of the variable
filter object Filter by environment scope

create_group_variable

✏️ Writes

Create a CI/CD variable for a group. Use this for a new resource or action; choose the corresponding update or edit tool when the resource already exists. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
group_id string ✓ Group ID or URL-encoded path
key string ✓ The key of the variable (must match /[a-zA-Z0-9_]+/)
value string ✓ The value of the variable
variable_type enum (env_var | file) The type of variable: 'env_var' (default) or 'file'
protected boolean Whether the variable is only available on protected branches/tags
masked boolean Whether the variable value is masked in job logs
raw boolean Whether the variable is not expanded (treated as raw string)
environment_scope string Environment scope (e.g. '', 'production'). Default: ''
description string Description of the variable

update_group_variable

✏️ Writes

Update an existing CI/CD variable in a group. Use this for an existing resource; choose the corresponding create tool for a new resource and a note tool for discussion-only text. It changes remote GitLab state and requires the necessary project or group permission; GitLab returns validation, conflict, permission, or rate-limit errors instead of silently applying an invalid request. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
group_id string ✓ Group ID or URL-encoded path
key string ✓ The key of the variable to update
value string ✓ The new value of the variable
variable_type enum (env_var | file) The type of variable
protected boolean Whether the variable is protected
masked boolean Whether the variable value is masked in job logs
raw boolean Whether the variable is not expanded
environment_scope string New environment scope to assign to the variable (renames the scope, e.g. '*', 'production'). Use filter.environment_scope to identify which variable to update when multiple share the same key.
description string Description of the variable
filter object Identifies which variable to update when multiple variables share the same key across different environment scopes

delete_group_variable

✏️ Writes

Delete a CI/CD variable from a group. Use this only after verifying the target; choose a get or list tool first when you need to inspect state without changing it. It changes or removes remote GitLab data and may be irreversible; it requires the necessary project or group permission and returns validation, conflict, permission, or rate-limit errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.

Parameters

Parameter Type Required Description
group_id string ✓ Group ID or URL-encoded path
key string ✓ The key of the variable to delete
filter object Filter by environment scope to disambiguate when multiple variables share the same key