GitLab API MCP Server
Manage repositories, CI/CD pipelines, and merge requests through your AI agent.
Quick Start Summary
The GitLab API MCP server is a Model Context Protocol bridge that connects AI assistants — including Claude Desktop, Cursor, Windsurf, and VS Code Copilot — to the GitLab API API through natural language. It exposes 3 API endpoints as callable tools, such as List projects, List merge requests, List pipelines. Authentication requires OAuth2 credentials, and setup takes approximately 2 minutes. The server uses STDIO transport and can be installed by running npx -y @gitlab/mcp-server. This integration is sourced from the community GitLab API OpenAPI specification (v4.0) and has a quality score of 58/99 (fair documentation coverage).
Server Details
- Category
- Developer Tools
- Authentication
- OAuth2
- Endpoints
- 3 operations
- Transport
- STDIO
- Spec Version
- v4.0
- Install Command
npx -y @gitlab/mcp-server
Environment Variables
GITLAB_TOKENExample: your_gitlab_token
Top Endpoints
/projectsList projects
/projects/{id}/merge_requestsList merge requests
/projects/{id}/pipelinesList pipelines
One-Click Install
Copy the snippet for your MCP client and paste it in — zero editing required.
Claude Desktop
Add to claude_desktop_config.json
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": [
"-y",
"@gitlab/mcp-server"
],
"env": {
"GITLAB_TOKEN": "your_gitlab_token"
}
}
}
}Cursor
Settings → MCP Servers → Add
{
"mcpServers": {
"gitlab": {
"url": "https://mcpbridge.org/config/gitlab.json"
}
}
}Saves as .cursor/mcp.json in the download. Move it to your project root.
VS Code
Use with MCP extension
{
"mcpServers": {
"gitlab": {
"url": "https://mcpbridge.org/config/gitlab.json"
}
}
}Endpoints Explorer
Search and browse the 3 operations supported by this server.
Multi-Language Code Examples
Executable code snippets for calling GitLab API endpoints in curl, TypeScript, or Python.
curl -X GET "https://gitlab.com/gitlab-org/openapi/-/raw/main/projects" \ -H "Content-Type: application/json" \ -H "Authorization: YOUR_API_KEY"
Manual Configuration
Directly add this block to your JSON config file, or use the hosted config registry URL.
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": ["-y","@gitlab/mcp-server"],
"env": {
"GITLAB_TOKEN": "your_gitlab_token"
}
}
}
}Authentication Details
This API requires OAuth2 credentials.
Variables to configure:
GITLAB_TOKEN
Documentation Links
Error Handling & HTTP Status Code Matrix
Common status codes, error causes, and resolution steps when invoking GitLab API endpoints.
400 Bad RequestCause: Malformed payload parameters or missing required fields.
Resolution: Verify request schema in Endpoints tab before calling tool.
401 UnauthorizedCause: Missing or invalid API key credentials.
Resolution: Set environment variable in MCP client config under env object.
403 ForbiddenCause: Insufficient scope permissions for requested resource.
Resolution: Verify key permissions in developer dashboard.
404 Not FoundCause: Resource URL path or requested entity ID does not exist.
Resolution: Check path variables and parameters.
429 Rate Limit ExceededCause: API rate limit quota exceeded.
Resolution: Implement exponential backoff retry in tool call.
500 Internal ErrorCause: Upstream server runtime fault.
Resolution: Inspect STDIO stderr output for log trace.
Quality Score
Checked against our protocol-compliance rules.
Specification Version: v4.0
Page compiled on: June 13, 2026
Own this API?
Verify ownership of this listing to control the description, configuration details, and documentation links. Choose between free manual verification or instant premium placement.
Option 1: Free Verification
Slow manual review. Requires creating a GitHub issue with verified documentation or domain verification.
- • Verified badge on page
- • Standard search sorting
- • 2-3 business days review
Option 2: Featured Upgrade($9/mo)
Instant verification plus premium styling, featured badges, and directory placement boost.
- • ★ Featured star & amber highlight border
- • Top of directory search placement
- • Instant activation via claim token
Similar APIs
Other APIs in the Developer Tools category.
GitHub API
Access GitHub repositories, issues, pull requests, and more. Integrate GitHub workflows directly into your AI agent.
OAuth2Box Platform API
The Box Platform API, provided by Box (box.com), is a robust and comprehensive RESTful service that enables deep integration with the Box cloud content management ecosystem. It serves as the programmatic backbone for enterprises and developers seeking to build custom applications and workflows that interact with content stored securely in Box. Its core capabilities extend far beyond basic file operations, encompassing a full spectrum of content lifecycle management. Developers can programmatically create, upload, download, search, and manage files and folders, but the API's true power lies in its enterprise-grade features. These include advanced collaboration management through invitations and permissions, granular user and group administration within an enterprise directory, and sophisticated security and compliance controls. Specific endpoint groups for managing collaboration whitelists and exempt targets allow for precise governance over external sharing policies, ensuring that content is only shared with approved domains. Furthermore, the API facilitates complex legal and compliance use cases, such as placing items on legal hold or applying retention policies, making it an indispensable tool for regulated industries and large organizations.
Asana
This API serves as the programmatic backbone for the Asana work management platform, provided by Asana, Inc. It enables developers to interact programmatically with one of the world's leading enterprise collaboration and productivity suites. The core capabilities of this interface center around the CRUD (Create, Read, Update, Delete) operations for fundamental Asana objects. Specifically, the provided endpoints grant control over project attachments—allowing for the uploading, retrieval, and management of files associated with tasks and projects—and custom fields, which are pivotal for creating structured, data-rich workflows. These custom fields allow organizations to define unique data types (like dropdown menus, text fields, or dates) to standardize information capture across projects, moving beyond basic task lists to true operational tracking. Typical use cases span from enterprise project management offices (PMOs) needing to programmatically generate status reports and audit attachments, to development teams automating the creation of bug-tracking projects with predefined custom fields for severity and status, to operational leaders building dashboards that aggregate and analyze custom field data for resource allocation insights.
clickup20
The clickup20 Polls API is a lightweight, focused web service designed to facilitate the creation and management of simple polling mechanisms. Provided by ClickUp, a platform known for its project management and productivity tools, this API serves as a specialized component for gathering quick, quantitative feedback. Its core capabilities are straightforward: it allows consumers to programmatically retrieve a list of existing poll questions and to submit new poll questions for consideration. Typical use cases span both enterprise and consumer domains. In an enterprise setting, a development team might integrate this API to run quick polls during sprint retrospectives, gauge internal sentiment on a new tool, or gather binary feedback on proposed technical designs within a project management workflow. For consumer applications, it could power simple feedback widgets within a mobile app or website, enabling users to vote on feature priorities or content topics. The API’s simplicity, requiring no authentication, makes it highly accessible for rapid prototyping and integration into internal tools where complex credential management is unnecessary.
Related MCP Server Integrations
GitHub API MCP Setup
Access GitHub repositories, issues, pull requests, and more. Integrate GitHub workflows directly into your AI agent.
Box Platform API MCP Setup
The Box Platform API, provided by Box (box.com), is a robust and comprehensive RESTful service that enables deep integration with the Box cloud content management ecosystem. It serves as the programmatic backbone for enterprises and developers seeking to build custom applications and workflows that interact with content stored securely in Box. Its core capabilities extend far beyond basic file operations, encompassing a full spectrum of content lifecycle management. Developers can programmatically create, upload, download, search, and manage files and folders, but the API's true power lies in its enterprise-grade features. These include advanced collaboration management through invitations and permissions, granular user and group administration within an enterprise directory, and sophisticated security and compliance controls. Specific endpoint groups for managing collaboration whitelists and exempt targets allow for precise governance over external sharing policies, ensuring that content is only shared with approved domains. Furthermore, the API facilitates complex legal and compliance use cases, such as placing items on legal hold or applying retention policies, making it an indispensable tool for regulated industries and large organizations.
Asana MCP Setup
This API serves as the programmatic backbone for the Asana work management platform, provided by Asana, Inc. It enables developers to interact programmatically with one of the world's leading enterprise collaboration and productivity suites. The core capabilities of this interface center around the CRUD (Create, Read, Update, Delete) operations for fundamental Asana objects. Specifically, the provided endpoints grant control over project attachments—allowing for the uploading, retrieval, and management of files associated with tasks and projects—and custom fields, which are pivotal for creating structured, data-rich workflows. These custom fields allow organizations to define unique data types (like dropdown menus, text fields, or dates) to standardize information capture across projects, moving beyond basic task lists to true operational tracking. Typical use cases span from enterprise project management offices (PMOs) needing to programmatically generate status reports and audit attachments, to development teams automating the creation of bug-tracking projects with predefined custom fields for severity and status, to operational leaders building dashboards that aggregate and analyze custom field data for resource allocation insights.
clickup20 MCP Setup
The clickup20 Polls API is a lightweight, focused web service designed to facilitate the creation and management of simple polling mechanisms. Provided by ClickUp, a platform known for its project management and productivity tools, this API serves as a specialized component for gathering quick, quantitative feedback. Its core capabilities are straightforward: it allows consumers to programmatically retrieve a list of existing poll questions and to submit new poll questions for consideration. Typical use cases span both enterprise and consumer domains. In an enterprise setting, a development team might integrate this API to run quick polls during sprint retrospectives, gauge internal sentiment on a new tool, or gather binary feedback on proposed technical designs within a project management workflow. For consumer applications, it could power simple feedback widgets within a mobile app or website, enabling users to vote on feature priorities or content topics. The API’s simplicity, requiring no authentication, makes it highly accessible for rapid prototyping and integration into internal tools where complex credential management is unnecessary.
The Plaid API MCP Setup
The Plaid API, provided by the financial technology company Plaid, serves as a critical infrastructure layer that enables applications to connect with users' bank accounts and financial data in a standardized, secure manner. Its core capabilities center on authentication, identity verification, and data retrieval from over 12,000 financial institutions. The specific endpoints listed, such as `accounts/balance/get` and `accounts/get`, allow applications to fetch detailed account information and real-time balance data. The `asset_report/*` suite of endpoints is particularly powerful for enterprise use cases, enabling the creation of comprehensive, auditable reports of a user's financial assets—a process essential for automated mortgage underwriting, lending decisions, wealth management onboarding, and financial planning. For consumers, this API powers the backend of popular personal finance apps, enabling features like account aggregation, spending analysis, and net worth tracking.