list_project_members
Retrieve a comprehensive list of all members in a GitLab project, including inherited members, by specifying project ID, query, and pagination options.
Instructions
List all members of a GitLab project (including inherited members)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | ||
| per_page | No | ||
| project_id | No | ||
| query | No |
Implementation Reference
- src/gitlab-api.ts:1366-1405 (handler)Core handler function that lists project members (including inherited) via GitLab API /projects/{projectId}/members/all endpoint. Supports query, pagination params. Parses response with GitLabMembersResponseSchema.
async listProjectMembers( projectId: string, options: { query?: string; page?: number; per_page?: number; } = {} ): Promise<GitLabMembersResponse> { const url = new URL( `${this.apiUrl}/projects/${encodeURIComponent(projectId)}/members/all` ); // Add query parameters Object.entries(options).forEach(([key, value]) => { if (value !== undefined) { url.searchParams.append(key, value.toString()); } }); const response = await fetch(url.toString(), { headers: { "Authorization": `Bearer ${this.token}` } }); if (!response.ok) { throw new McpError( ErrorCode.InternalError, `GitLab API error: ${response.statusText}` ); } const data = await response.json(); const totalCount = parseInt(response.headers.get("X-Total") || "0"); return GitLabMembersResponseSchema.parse({ count: totalCount, items: data }); } - src/schemas.ts:599-604 (schema)Input schema (Zod) for list_project_members tool defining required project_id and optional query/page/per_page params.
export const ListProjectMembersSchema = z.object({ project_id: z.string(), query: z.string().optional(), page: z.number().optional(), per_page: z.number().optional(), }); - src/index.ts:268-272 (registration)Tool registration in ALL_TOOLS array: defines name, description, inputSchema (from ListProjectMembersSchema), readOnly flag.
name: "list_project_members", description: "List all members of a GitLab project (including inherited members)", inputSchema: createJsonSchema(ListProjectMembersSchema), readOnly: true }, - src/index.ts:673-678 (handler)MCP server switch-case dispatcher: parses args with schema, extracts params, calls gitlabApi.listProjectMembers, returns formatted response.
case "list_project_members": { const args = ListProjectMembersSchema.parse(request.params.arguments); const { project_id, ...options } = args; const members = await gitlabApi.listProjectMembers(project_id, options); return formatMembersResponse(members); } - src/schemas.ts:628-633 (schema)Output response schema (Zod) for members list: count and array of GitLabMember objects.
export const GitLabMembersResponseSchema = z.object({ count: z.number(), items: z.array(GitLabMemberSchema) }); export type GitLabMembersResponse = z.infer<typeof GitLabMembersResponseSchema>;