list_merge_requests
Read-only
Retrieve merge requests from GitLab, scoped to a project or across all accessible projects, with optional filters for state, labels, author, assignee, and search terms.
Instructions
List merge requests (without project_id: user's MRs; with project_id: project MRs). Use this for a collection of resources; choose the corresponding get tool when you already know the single resource to inspect. It is read-only and does not mutate GitLab data; missing resources, invalid identifiers, insufficient permission, and rate limits are returned as errors. When project_id or group_id is accepted, provide the numeric ID or complete URL-encoded path described by the schema; use required identifiers and pagination fields exactly as documented.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| wip | No | Filter merge requests against their wip status | |
| page | No | Page number for pagination (default: 1) | |
| sort | No | Return merge requests sorted in ascending or descending order | |
| scope | No | Return merge requests from a specific scope | |
| state | No | Return merge requests with a specific state | |
| labels | No | Array of label names | |
| search | No | Search for specific terms | |
| order_by | No | Return merge requests ordered by the given field | |
| per_page | No | Number of items per page (max: 100, default: 20) | |
| author_id | No | Returns merge requests created by the given user ID (integer). Mutually exclusive with author_username. | |
| milestone | No | Milestone title | |
| project_id | No | Project ID or URL-encoded path (optional - if not provided, lists all merge requests the user has access to) | |
| assignee_id | No | Return MRs assigned to the given user ID (integer), 'none', or 'any'. Mutually exclusive with assignee_username. | |
| reviewer_id | No | Returns merge requests which have the user as a reviewer. Must be an integer, 'none', or 'any'. Mutually exclusive with reviewer_username. | |
| created_after | No | Return merge requests created after the given time | |
| source_branch | No | Return merge requests from a specific source branch | |
| target_branch | No | Return merge requests targeting a specific branch | |
| updated_after | No | Return merge requests updated after the given time | |
| created_before | No | Return merge requests created before the given time | |
| updated_before | No | Return merge requests updated before the given time | |
| author_username | No | Returns merge requests created by the given username. Mutually exclusive with author_id. | |
| assignee_username | No | Returns merge requests assigned to the given username. Mutually exclusive with assignee_id. | |
| reviewer_username | No | Returns merge requests which have the user as a reviewer by username. Mutually exclusive with reviewer_id. | |
| with_labels_details | No | Return more details for each label | |
| approved_by_usernames | No | Returns merge requests approved by the given usernames (array). |