gitlab-projects

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 path
    • •owned (Optional[bool]): Optional. - Filter projects owned by the authenticated user
    • •search (Optional[str]): Optional. - Filter projects by search term in name or path
    • •sort (Optional[str]): Optional. - Sort projects by criteria (e.g., 'created_at', 'name')
    • •visibility (Optional[str]): Optional. - Filter projects by visibility (e.g., 'public', 'private')
• •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
• •get_project_contributors: Retrieve a list of contributors to a specific GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
• •get_project_statistics: Retrieve statistics for a specific GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
• •edit_project: Edit a specific GitLab project's details (name, description, or visibility).
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •name (Optional[str]): Optional. - New name of the project
    • •description (Optional[str]): Optional. - New description of the project
    • •visibility (Optional[str]): Optional. - New visibility of the project (e.g., 'public', 'private')
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •get_project_groups: Retrieve a list of groups associated with a specific GitLab project, optionally filtered.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •skip_groups (Optional[List[int]]): Optional. - List of group IDs to exclude
    • •search (Optional[str]): Optional. - Filter groups by search term in name
• •archive_project: Archive a specific GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •unarchive_project: Unarchive a specific GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •delete_project: Delete a specific GitLab project.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •ctx (Optional[Context]): Optional. - MCP context for progress
• •share_project: Share a specific GitLab project with a group, specifying access level.
  • •Parameters:
    • •project_id (str): Optional. - Project ID or path
    • •group_id (str): Optional. - Group ID or path to share with
    • •group_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 format
    • •ctx (Optional[Context]): Optional. - MCP context for progress

Usage Instructions

1. •Use visibility for updates.

Examples

• •Edit: edit_project with project_id="123", visibility="public".
• •Share: share_project with project_id="123", group_id="group", group_access="maintainer".

Error Handling

• •Deletion permanent: Confirm first.