list_group_projects

Retrieve and filter projects within a GitLab group using criteria like visibility, programming language, or activity status to manage development resources.

Instructions

List projects in a GitLab group with filtering options

Input Schema

TableJSON Schema

Name	Required	Description
`group_id`	No	Group ID or path
`include_subgroups`	No	Include projects from subgroups
`search`	No	Search term to filter projects
`order_by`	No	Field to sort by
`sort`	No	Sort direction
`archived`	No	Filter for archived projects
`visibility`	No	Filter by project visibility
`with_issues_enabled`	No	Filter projects with issues feature enabled
`with_merge_requests_enabled`	No	Filter projects with merge requests feature enabled
`min_access_level`	No	Filter by minimum access level
`with_programming_language`	No	Filter by programming language
`starred`	No	Filter by starred projects
`statistics`	No	Include project statistics
`with_custom_attributes`	No	Include custom attributes
`with_security_reports`	No	Include security reports
`page`	No	Page number for pagination (default: 1)
`per_page`	No	Number of items per page (max: 100, default: 20)

Implementation Reference

schemas.ts:1495-1526 (schema)

Zod input schema definition for the 'list_group_projects' MCP tool. Validates parameters for listing projects within a GitLab group, including group_id (required), pagination, filters like include_subgroups, search, visibility, etc. Uses GitLab API endpoint /groups/{group_id}/projects.

export const ListGroupProjectsSchema = z
  .object({
    group_id: z.coerce.string().describe("Group ID or path"),
    include_subgroups: z.boolean().optional().describe("Include projects from subgroups"),
    search: z.string().optional().describe("Search term to filter projects"),
    order_by: z
      .enum(["name", "path", "created_at", "updated_at", "last_activity_at"])
      .optional()
      .describe("Field to sort by"),
    sort: z.enum(["asc", "desc"]).optional().describe("Sort direction"),
    archived: z.boolean().optional().describe("Filter for archived projects"),
    visibility: z
      .enum(["public", "internal", "private"])
      .optional()
      .describe("Filter by project visibility"),
    with_issues_enabled: z
      .boolean()
      .optional()
      .describe("Filter projects with issues feature enabled"),
    with_merge_requests_enabled: z
      .boolean()
      .optional()
      .describe("Filter projects with merge requests feature enabled"),
    min_access_level: z.number().optional().describe("Filter by minimum access level"),
    with_programming_language: z.string().optional().describe("Filter by programming language"),
    starred: z.boolean().optional().describe("Filter by starred projects"),
    statistics: z.boolean().optional().describe("Include project statistics"),
    with_custom_attributes: z.boolean().optional().describe("Include custom attributes"),
    with_security_reports: z.boolean().optional().describe("Include security reports"),
  })
  .merge(PaginationOptionsSchema);

gitlab mcp