gitlab-mcp

MCP.Pizza Chef: zereight

The gitlab-mcp server is an improved Model Context Protocol server for GitLab, offering bug fixes and enhancements over the original implementation. It provides seamless integration with GitLab APIs, supports read-only and wiki modes, and is compatible with various MCP hosts like Claude App, Cline, Roo Code, and Cursor. This server enables real-time, structured access to GitLab data for AI models, facilitating advanced workflows and automation.

Use This MCP server To

Integrate GitLab data into AI workflows for real-time context Enable AI models to query GitLab issues and merge requests Support read-only access to GitLab repositories for analysis Use GitLab wiki content as contextual knowledge for models Automate project status summaries from GitLab data Facilitate multi-step reasoning on GitLab project information Combine GitLab data with other MCP servers for enriched context

README

Better GitLab MCP Server

@zereight/mcp-gitlab

smithery badge

GitLab MCP(Model Context Protocol) Server. Includes bug fixes and improvements over the original GitLab MCP server.

gitlab mcp MCP server

Usage

Using with Claude App, Cline, Roo Code, Cursor

When using with the Claude App, you need to set up your API key and URLs directly.

{
  "mcpServers": {
    "GitLab communication server": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-gitlab"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token",
        "GITLAB_API_URL": "your_gitlab_api_url",
        "GITLAB_READ_ONLY_MODE": "false",
        "USE_GITLAB_WIKI":"true"
      }
    }
  }
}

Environment Variables

  • GITLAB_PERSONAL_ACCESS_TOKEN: Your GitLab personal access token.
  • GITLAB_API_URL: Your GitLab API URL. (Default: https://gitlab.com/api/v4)
  • GITLAB_READ_ONLY_MODE: When set to 'true', restricts the server to only expose read-only operations. Useful for enhanced security or when write access is not needed. Also useful for using with Cursor and it's 40 tool limit.
  • USE_GITLAB_WIKI: When set to 'true', enables the wiki-related tools (list_wiki_pages, get_wiki_page, create_wiki_page, update_wiki_page, delete_wiki_page). By default, wiki features are disabled.

Tools 🛠️

+

  1. create_or_update_file - Create or update a single file in a GitLab project
  2. search_repositories - Search for GitLab projects
  3. create_repository - Create a new GitLab project
  4. get_file_contents - Get the contents of a file or directory from a GitLab project
  5. push_files - Push multiple files to a GitLab project in a single commit
  6. create_issue - Create a new issue in a GitLab project
  7. create_merge_request - Create a new merge request in a GitLab project
  8. fork_repository - Fork a GitLab project to your account or specified namespace
  9. create_branch - Create a new branch in a GitLab project
  10. get_merge_request - Get details of a merge request (Either mergeRequestIid or branchName must be provided)
  11. get_merge_request_diffs - Get the changes/diffs of a merge request (Either mergeRequestIid or branchName must be provided)
  12. update_merge_request - Update a merge request (Either mergeRequestIid or branchName must be provided)
  13. create_note - Create a new note (comment) to an issue or merge request
  14. mr_discussions - List discussion items for a merge request
  15. update_merge_request_note - Modify an existing merge request thread note
  16. list_issues - List issues in a GitLab project with filtering options
  17. get_issue - Get details of a specific issue in a GitLab project
  18. update_issue - Update an issue in a GitLab project
  19. delete_issue - Delete an issue from a GitLab project
  20. list_issue_links - List all issue links for a specific issue
  21. get_issue_link - Get a specific issue link
  22. create_issue_link - Create an issue link between two issues
  23. delete_issue_link - Delete an issue link
  24. list_namespaces - List all namespaces available to the current user
  25. get_namespace - Get details of a namespace by ID or path
  26. verify_namespace - Verify if a namespace path exists
  27. get_project - Get details of a specific project
  28. list_projects - List projects accessible by the current user
  29. list_labels - List labels for a project
  30. get_label - Get a single label from a project
  31. create_label - Create a new label in a project
  32. update_label - Update an existing label in a project
  33. delete_label - Delete a label from a project
  34. list_group_projects - List projects in a GitLab group with filtering options
  35. list_wiki_pages - List wiki pages in a GitLab project
  36. get_wiki_page - Get details of a specific wiki page
  37. create_wiki_page - Create a new wiki page in a GitLab project
  38. update_wiki_page - Update an existing wiki page in a GitLab project
  39. delete_wiki_page - Delete a wiki page from a GitLab project
  40. get_repository_tree - Get the repository tree for a GitLab project (list files and directories)

gitlab-mcp FAQ

How do I configure the gitlab-mcp server with my GitLab instance?
Set environment variables like GITLAB_PERSONAL_ACCESS_TOKEN and GITLAB_API_URL to connect your GitLab instance securely.
Can gitlab-mcp operate in read-only mode?
Yes, you can enable read-only mode by setting the GITLAB_READ_ONLY_MODE environment variable to true.
Is it possible to include GitLab wiki content in the context?
Yes, setting USE_GITLAB_WIKI to true allows the server to expose wiki pages as part of the model context.
Which MCP hosts are compatible with gitlab-mcp?
It works with Claude App, Cline, Roo Code, Cursor, and other MCP-compatible clients.
Does gitlab-mcp support multiple GitLab API versions?
The server is designed to work with standard GitLab API endpoints; compatibility depends on your GitLab version but generally supports recent releases.
How does gitlab-mcp improve over the original GitLab MCP server?
It includes bug fixes and performance improvements for more reliable and efficient GitLab data access.
Can I use gitlab-mcp for private GitLab instances?
Yes, by configuring the API URL and access token, you can connect to private or self-hosted GitLab servers.
What security measures are recommended when using gitlab-mcp?
Use secure storage for your personal access tokens and restrict permissions to minimize risk.