Projects & Namespaces¶
Project/namespace listing, member queries, group iterations, and server health.
Tools in this group¶
get_project— 📖 Read-onlylist_projects— 📖 Read-onlyupdate_project— ✏️ Writeslist_project_members— 📖 Read-onlylist_group_members— 📖 Read-onlylist_namespaces— 📖 Read-onlyget_namespace— 📖 Read-onlyverify_namespace— 📖 Read-onlylist_group_projects— 📖 Read-onlylist_group_iterations— 📖 Read-onlyhealth_check— 📖 Read-only
get_project¶
📖 Read-only
Get details of a specific 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 |
list_projects¶
📖 Read-only
List projects accessible by the current user. 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 |
|---|---|---|---|
search |
string | Search term for projects | |
search_namespaces |
boolean | Needs to be true if search is full path | |
owned |
boolean | Filter for projects owned by current user | |
membership |
boolean | Filter for projects where current user is a member | |
simple |
boolean | Return only limited fields | |
archived |
boolean | Filter for archived projects | |
visibility |
enum (public | internal | private) |
Filter by project visibility | |
order_by |
enum (id | name | path | created_at | updated_at | last_activity_at) |
Return projects ordered by field | |
sort |
enum (asc | desc) |
Return projects sorted in ascending or descending order | |
with_issues_enabled |
boolean | Filter projects with issues feature enabled | |
with_merge_requests_enabled |
boolean | Filter projects with merge requests feature enabled | |
min_access_level |
number | Filter by minimum access level | |
topic |
string | Filter by topic (projects tagged with this topic) | |
page |
number | Page number for pagination (default: 1) | |
per_page |
number | Number of items per page (max: 100, default: 20) |
update_project¶
✏️ Writes
Update project settings such as description, visibility, default branch, and feature access levels. 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 complete URL-encoded path to project | |
name |
string | Project display name | |
path |
string | Project path/slug | |
description |
string | Project description | |
default_branch |
string | Default branch name | |
visibility |
enum (private | internal | public) |
Project visibility | |
topics |
array |
Project topics | |
request_access_enabled |
boolean | Allow users to request access | |
remove_source_branch_after_merge |
boolean | Remove source branches after merge by default | |
only_allow_merge_if_pipeline_succeeds |
boolean | Require successful pipeline before merge | |
only_allow_merge_if_all_discussions_are_resolved |
boolean | Require all discussions to be resolved before merge | |
squash_option |
enum (never | always | default_on | default_off) |
Squash commits setting | |
merge_method |
enum (merge | rebase_merge | ff) |
Merge method | |
issues_access_level |
enum (disabled | private | enabled) |
Issues feature visibility | |
merge_requests_access_level |
enum (disabled | private | enabled) |
Merge requests feature visibility | |
builds_access_level |
enum (disabled | private | enabled) |
CI/CD pipelines feature visibility | |
wiki_access_level |
enum (disabled | private | enabled) |
Wiki feature visibility | |
snippets_access_level |
enum (disabled | private | enabled) |
Snippets feature visibility | |
container_registry_access_level |
enum (disabled | private | enabled) |
Container registry feature visibility | |
environments_access_level |
enum (disabled | private | enabled) |
Environments feature visibility | |
forking_access_level |
enum (disabled | private | enabled) |
Forking feature visibility | |
package_registry_access_level |
enum (disabled | private | enabled) |
Package registry feature visibility | |
pages_access_level |
enum (disabled | private | enabled | public) |
Pages feature visibility |
list_project_members¶
📖 Read-only
List members of a GitLab 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 |
query |
string | Search for members by name or username | |
user_ids |
array |
Filter by user IDs | |
skip_users |
array |
User IDs to exclude | |
include_inheritance |
boolean | Include inherited members. Defaults to false. | |
per_page |
number | Number of items per page (default: 20, max: 100) | |
page |
number | Page number for pagination (default: 1) |
list_group_members¶
📖 Read-only
List members of a GitLab group with optional name or username search. 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 |
query |
string | Search for members by name or username | |
user_ids |
array |
Filter by user IDs | |
skip_users |
array |
User IDs to exclude | |
include_inheritance |
boolean | Include inherited members. Defaults to false. | |
per_page |
number | Number of items per page (default: 20, max: 100) | |
page |
number | Page number for pagination (default: 1) |
list_namespaces¶
📖 Read-only
List all namespaces (users and groups) available to the current user. Filter by kind='group' for groups only. 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 |
|---|---|---|---|
search |
string | Search term for namespaces | |
owned |
boolean | Filter for namespaces owned by current user | |
page |
number | Page number for pagination (default: 1) | |
per_page |
number | Number of items per page (max: 100, default: 20) |
get_namespace¶
📖 Read-only
Get details of a namespace (user or group) by ID or path. Groups are namespaces with kind='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 |
|---|---|---|---|
namespace_id |
string | ✓ | Namespace ID or full path |
verify_namespace¶
📖 Read-only
Verify if a namespace path exists. Use parent_id to scope the check to a specific parent namespace — required for nested namespaces where the same path may exist under different parents.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
path |
string | ✓ | Namespace path to verify |
parent_id |
integer | Parent namespace ID; required to correctly resolve paths in nested namespaces where the same path may exist under different parents |
list_group_projects¶
📖 Read-only
List projects in 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 path |
include_subgroups |
boolean | Include projects from subgroups | |
search |
string | Search term to filter projects | |
order_by |
enum (name | path | created_at | updated_at | last_activity_at) |
Field to sort by | |
sort |
enum (asc | desc) |
Sort direction | |
archived |
boolean | Filter for archived projects | |
visibility |
enum (public | internal | private) |
Filter by project visibility | |
with_issues_enabled |
boolean | Filter projects with issues feature enabled | |
with_merge_requests_enabled |
boolean | Filter projects with merge requests feature enabled | |
min_access_level |
number | Filter by minimum access level | |
with_programming_language |
string | Filter by programming language | |
starred |
boolean | Filter by starred projects | |
statistics |
boolean | Include project statistics | |
with_custom_attributes |
boolean | Include custom attributes | |
with_security_reports |
boolean | Include security reports | |
topic |
string | Filter by topic (projects tagged with this topic) | |
page |
number | Page number for pagination (default: 1) | |
per_page |
number | Number of items per page (max: 100, default: 20) |
list_group_iterations¶
📖 Read-only
List group iterations with filtering options. 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 |
state |
enum (opened | upcoming | current | closed | all) |
Return opened, upcoming, current, closed, or all iterations. | |
search |
string | Return only iterations with a title matching the provided string. | |
search_in |
arraycadence_title)> |
Fields in which fuzzy search should be performed with the query given in the argument search. The available options are title and cadence_title. Default is [title]. | |
include_ancestors |
boolean | Include iterations for group and its ancestors. Defaults to true. | |
include_descendants |
boolean | Include iterations for group and its descendants. Defaults to false. | |
updated_before |
string | Return only iterations updated before the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | |
updated_after |
string | Return only iterations updated after the given datetime. Expected in ISO 8601 format (2019-03-15T08:00:00Z). | |
page |
number | Page number for pagination (default: 1) | |
per_page |
number | Number of items per page (max: 100, default: 20) |
health_check¶
📖 Read-only
Verify server status and authentication. When authenticated, also reports the GitLab instance version from GET /api/v4/version (version, revision, enterprise). Version lookup failures do not fail the health check — those fields are omitted. Use this to verify server connectivity and authentication before making GitLab requests; use whoami when the authenticated user's identity is the goal. It does not mutate GitLab state and returns server/authentication status plus GitLab version details when available.
Parameters
No parameters.