gitlab_list_group_projects

Retrieve a list of projects within a specific GitLab group, including optional search, pagination, and subgroup inclusion. Simplify group hierarchy navigation and project discovery.

Instructions

List projects within a group Returns: Array of projects belonging to the specified group Use when: Browsing group projects, finding projects in group hierarchy Pagination: Yes (default 50 per page) Options: Include subgroup projects with include_subgroups=true

Example response: [{ "id": 456, "name": "project-one", "path_with_namespace": "my-group/project-one", "description": "First project in group", "web_url": "https://gitlab.com/my-group/project-one" }]

Related tools:

gitlab_get_group: Get group details
gitlab_get_project: Get full project details

Input Schema

Name	Required	Description
`group_id`	Yes	Group identifier Type: integer OR string Format: numeric ID or 'group/subgroup' path Required: Yes Examples: - 456 (numeric ID) - 'my-group' (group path) - 'parent-group/sub-group' (nested group path)
`include_subgroups`	No	Include projects from subgroups Type: boolean Default: false Options: - true: Include all descendant group projects - false: Only direct group projects Use case: Navigating hierarchical group structures
`page`	No	Page number for pagination Type: integer Range: ≥1 Default: 1 Example: 3 (to get the third page of results) Note: Use with per_page to navigate large result sets
`per_page`	No	Number of results per page Type: integer Range: 1-100 Default: 20 Example: 50 (for faster browsing) Tip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing
`search`	No	Search query Type: string Matching: Case-insensitive, partial matching Searches in: Project names and descriptions Examples: - 'frontend' (finds 'frontend-app', 'old-frontend', etc.) - 'API' (matches 'api', 'API', 'GraphQL-API', etc.) Tip: Use specific terms for better results for projects

Input Schema (JSON Schema)

{
  "properties": {
    "group_id": {
      "description": "Group identifier\nType: integer OR string\nFormat: numeric ID or 'group/subgroup' path\nRequired: Yes\nExamples:\n  - 456 (numeric ID)\n  - 'my-group' (group path)\n  - 'parent-group/sub-group' (nested group path)",
      "type": "string"
    },
    "include_subgroups": {
      "default": false,
      "description": "Include projects from subgroups\nType: boolean\nDefault: false\nOptions:\n  - true: Include all descendant group projects\n  - false: Only direct group projects\nUse case: Navigating hierarchical group structures",
      "type": "boolean"
    },
    "page": {
      "default": 1,
      "description": "Page number for pagination\nType: integer\nRange: ≥1\nDefault: 1\nExample: 3 (to get the third page of results)\nNote: Use with per_page to navigate large result sets",
      "minimum": 1,
      "type": "integer"
    },
    "per_page": {
      "default": 50,
      "description": "Number of results per page\nType: integer\nRange: 1-100\nDefault: 20\nExample: 50 (for faster browsing)\nTip: Use smaller values (10-20) for detailed operations, larger (50-100) for listing",
      "maximum": 100,
      "minimum": 1,
      "type": "integer"
    },
    "search": {
      "description": "Search query\nType: string\nMatching: Case-insensitive, partial matching\nSearches in: Project names and descriptions\nExamples:\n  - 'frontend' (finds 'frontend-app', 'old-frontend', etc.)\n  - 'API' (matches 'api', 'API', 'GraphQL-API', etc.)\nTip: Use specific terms for better results for projects",
      "type": "string"
    }
  },
  "required": [
    "group_id"
  ],
  "type": "object"
}

MCP GitLab Server