| name | gitlab-projects |
| description | Manages GitLab projects. Use for listing, editing, archiving, sharing projects. Triggers: repo management. |
Overview
Handles project lifecycle.
Available Tools
get_projects: Retrieve a list of projects, optionally filtered by ownership, search, sort, or visibility or Retrieve details of a specific GitLab project.- Parameters:
project_id(Optional[str]): Optional. - Project ID or pathowned(Optional[bool]): Optional. - Filter projects owned by the authenticated usersearch(Optional[str]): Optional. - Filter projects by search term in name or pathsort(Optional[str]): Optional. - Sort projects by criteria (e.g., 'created_at', 'name')visibility(Optional[str]): Optional. - Filter projects by visibility (e.g., 'public', 'private')
- Parameters:
get_nested_projects_by_group: Retrieve a list of nested projects within a GitLab group, including descendant groups.- Parameters:
group_id(str): Optional. - Group ID or path
- Parameters:
get_project_contributors: Retrieve a list of contributors to a specific GitLab project.- Parameters:
project_id(str): Optional. - Project ID or path
- Parameters:
get_project_statistics: Retrieve statistics for a specific GitLab project.- Parameters:
project_id(str): Optional. - Project ID or path
- Parameters:
edit_project: Edit a specific GitLab project's details (name, description, or visibility).- Parameters:
project_id(str): Optional. - Project ID or pathname(Optional[str]): Optional. - New name of the projectdescription(Optional[str]): Optional. - New description of the projectvisibility(Optional[str]): Optional. - New visibility of the project (e.g., 'public', 'private')ctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
get_project_groups: Retrieve a list of groups associated with a specific GitLab project, optionally filtered.- Parameters:
project_id(str): Optional. - Project ID or pathskip_groups(Optional[List[int]]): Optional. - List of group IDs to excludesearch(Optional[str]): Optional. - Filter groups by search term in name
- Parameters:
archive_project: Archive a specific GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
unarchive_project: Unarchive a specific GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
delete_project: Delete a specific GitLab project.- Parameters:
project_id(str): Optional. - Project ID or pathctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
share_project: Share a specific GitLab project with a group, specifying access level.- Parameters:
project_id(str): Optional. - Project ID or pathgroup_id(str): Optional. - Group ID or path to share withgroup_access(str): Optional. - Access level for the group (e.g., 'guest', 'developer', 'maintainer')expires_at(Optional[str]): Optional. - Expiration date for the share in ISO 8601 formatctx(Optional[Context]): Optional. - MCP context for progress
- Parameters:
Usage Instructions
- Use visibility for updates.
Examples
- Edit:
edit_projectwith project_id="123", visibility="public". - Share:
share_projectwith project_id="123", group_id="group", group_access="maintainer".
Error Handling
- Deletion permanent: Confirm first.