gitlab_list_groups

List accessible GitLab groups with IDs, names, paths, and descriptions. Supports pagination, filtering by ownership, and name search for efficient group navigation and management.

Instructions

List accessible GitLab groups Returns: Array of groups with ID, name, path, description Use when: Browsing groups, finding group IDs, navigating group hierarchy Pagination: Yes (default 50 per page) Filtering: By ownership, name search

Example response: [{ "id": 123, "name": "My Group", "path": "my-group", "full_path": "parent-group/my-group", "description": "Group for team projects", "web_url": "https://gitlab.com/groups/my-group", "visibility": "private" }]

Related tools:

gitlab_get_group: Get full group details
gitlab_list_group_projects: List projects in a group

Input Schema

Name	Required	Description
`owned`	No	Filter for owned groups only Type: boolean Default: false Options: - true: Only groups where you are the owner - false: All accessible groups Use case: Managing your own groups
`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 groups

Input Schema (JSON Schema)

{
  "properties": {
    "owned": {
      "default": false,
      "description": "Filter for owned groups only\nType: boolean\nDefault: false\nOptions:\n  - true: Only groups where you are the owner\n  - false: All accessible groups\nUse case: Managing your own groups",
      "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 groups",
      "type": "string"
    }
  },
  "type": "object"
}

MCP GitLab Server