GitLab REST API
GitLab REST API for discovering projects, users, issues, repository commits, branches, and project metadata.
Connect this API to an AI agent Browse all specs
What you can do with GitLab REST API via MCP
Every endpoint below becomes a governed tool your AI agent (Claude, ChatGPT, or a customer-facing VX agent) can call — with scoped permissions, sandbox testing, and audit logs.
| Method | Path | Operation | Description |
|---|---|---|---|
| GET | /projects |
get_projects | List and search projects Method: GET Path: /projects IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - search: Project name or path search - page: Page number - per_page: Results per page |
| GET | /projects/{id} |
get_projects_id | Get a project Method: GET Path: /projects/{id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: Numeric project ID or URL-encoded path |
| GET | /projects/{id}/issues |
get_projects_id_issues | List project issues Method: GET Path: /projects/{id}/issues IMPORTANT: This function has 1 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: Numeric project ID or URL-encoded path Query Parameters: OPTIONAL: - state: Issue state - page: Page number - per_page: Results per page |
| GET | /projects/{id}/repository/commits |
get_projects_id_repository_commits | List repository commits Method: GET Path: /projects/{id}/repository/commits IMPORTANT: This function has 1 REQUIRED parameter(s) and 2 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - id: Numeric project ID or URL-encoded path Query Parameters: OPTIONAL: - ref_name: Branch or tag name - page: Page number |
| GET | /users |
get_users | List or search users Method: GET Path: /users IMPORTANT: This function has 0 REQUIRED parameter(s) and 3 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Query Parameters: OPTIONAL: - username: Exact username - search: Search name or username - page: Page number |
| GET | /users/{user_id} |
get_users_user_id | Get a user Method: GET Path: /users/{user_id} IMPORTANT: This function has 1 REQUIRED parameter(s) and 0 OPTIONAL parameter(s) REQUIRED parameters MUST be provided OPTIONAL parameters can be omitted if not needed Parameters: Path Parameters: REQUIRED: - user_id: Numeric user ID |
Usage guide
Create a personal, project, or group access token in GitLab Preferences > Access Tokens or the relevant project/group settings. Send the raw token in the `PRIVATE-TOKEN` header, or use OAuth Bearer authentication where appropriate. Grant only read scopes needed for these operations and keep the token server-side. Official documentation: https://docs.gitlab.com/api/
How to use this spec
- Create a free VX Agents account (sandbox tools included).
- Open the marketplace and connect “GitLab REST API” to an agent.
- Expose it as an MCP server for Claude/ChatGPT, or chat with it directly.