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 | Default |
|---|---|---|---|
| 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);