gitlab_list_project_members
Retrieve and manage GitLab project members, including access levels, with a searchable interface. Use to view direct or inherited permissions and identify team roles efficiently. Supports pagination for large teams.
Instructions
List project members Returns: Users with access levels Use when: Finding team members, permissions Shows: Direct and inherited members
Access levels:
10: Guest
20: Reporter
30: Developer
40: Maintainer
50: Owner
Related tools:
gitlab_add_project_member: Add member
gitlab_update_member_role: Change access
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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 | |
| project_id | No | Project identifier (auto-detected if not provided) Type: integer OR string Format: numeric ID or 'namespace/project' Optional: Yes - auto-detects from current git repository Examples: - 12345 (numeric ID) - 'gitlab-org/gitlab' (namespace/project path) - 'my-group/my-subgroup/my-project' (nested groups) Note: If in a git repo with GitLab remote, this can be omitted | |
| query | No | Search query Type: string Format: Free text search Searches in: Usernames, names, emails Matching: Partial, case-insensitive Examples: - 'john' (finds 'john', 'johnny', 'Johnson') - 'admin' (finds users with admin in name) - 'example.com' (finds users with that email domain) |
Input Schema (JSON Schema)
{
"properties": {
"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"
},
"project_id": {
"description": "Project identifier (auto-detected if not provided)\nType: integer OR string\nFormat: numeric ID or 'namespace/project'\nOptional: Yes - auto-detects from current git repository\nExamples:\n - 12345 (numeric ID)\n - 'gitlab-org/gitlab' (namespace/project path)\n - 'my-group/my-subgroup/my-project' (nested groups)\nNote: If in a git repo with GitLab remote, this can be omitted",
"type": "string"
},
"query": {
"description": "Search query\nType: string\nFormat: Free text search\nSearches in: Usernames, names, emails\nMatching: Partial, case-insensitive\nExamples:\n - 'john' (finds 'john', 'johnny', 'Johnson')\n - 'admin' (finds users with admin in name)\n - 'example.com' (finds users with that email domain)",
"type": "string"
}
},
"type": "object"
}