Skip to main content
Glama

GitLab MCP Server

by harshmaur

Better GitLab MCP Server

@zereight/mcp-gitlab

GitLab MCP(Model Context Protocol) Server. Includes bug fixes and improvements over the original GitLab 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.

npx
{ "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": "false", // use wiki api? "USE_MILESTONE": "false", // use milestone api? "USE_PIPELINE": "false" // use pipeline api? } } } }
Docker
  • stdio
{ "mcpServers": { "GitLab communication server": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "GITLAB_PERSONAL_ACCESS_TOKEN", "-e", "GITLAB_API_URL", "-e", "GITLAB_READ_ONLY_MODE", "-e", "USE_GITLAB_WIKI", "-e", "USE_MILESTONE", "-e", "USE_PIPELINE", "iwakitakuma/gitlab-mcp" ], "env": { "GITLAB_PERSONAL_ACCESS_TOKEN": "your_gitlab_token", "GITLAB_API_URL": "https://gitlab.com/api/v4", // Optional, for self-hosted GitLab "GITLAB_READ_ONLY_MODE": "false", "USE_GITLAB_WIKI": "true", "USE_MILESTONE": "true", "USE_PIPELINE": "true" } } } }
  • sse
docker run -i --rm \ -e GITLAB_PERSONAL_ACCESS_TOKEN=your_gitlab_token \ -e GITLAB_API_URL= "https://gitlab.com/api/v4"\ -e GITLAB_READ_ONLY_MODE=true \ -e USE_GITLAB_WIKI=true \ -e USE_MILESTONE=true \ -e USE_PIPELINE=true \ -e SSE=true \ -p 3333:3002 \ iwakitakuma/gitlab-mcp
{ "mcpServers": { "GitLab communication server": { "url": "http://localhost:3333/sse" } } }
Docker Image Push
$ sh scripts/image_push.sh docker_user_name

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.
  • USE_MILESTONE: When set to 'true', enables the milestone-related tools (list_milestones, get_milestone, create_milestone, edit_milestone, delete_milestone, get_milestone_issue, get_milestone_merge_requests, promote_milestone, get_milestone_burndown_events). By default, milestone features are disabled.
  • USE_PIPELINE: When set to 'true', enables the pipeline-related tools (list_pipelines, get_pipeline, list_pipeline_jobs, get_pipeline_job, get_pipeline_job_output, create_pipeline, retry_pipeline, cancel_pipeline). By default, pipeline 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. get_branch_diffs - Get the changes/diffs between two branches or commits in a GitLab project
  13. update_merge_request - Update a merge request (Either mergeRequestIid or branchName must be provided)
  14. create_note - Create a new note (comment) to an issue or merge request
  15. create_merge_request_thread - Create a new thread on a merge request
  16. mr_discussions - List discussion items for a merge request
  17. update_merge_request_note - Modify an existing merge request thread note
  18. create_merge_request_note - Add a new note to an existing merge request thread
  19. update_issue_note - Modify an existing issue thread note
  20. create_issue_note - Add a new note to an existing issue thread
  21. list_issues - List issues in a GitLab project with filtering options
  22. get_issue - Get details of a specific issue in a GitLab project
  23. update_issue - Update an issue in a GitLab project
  24. delete_issue - Delete an issue from a GitLab project
  25. list_issue_links - List all issue links for a specific issue
  26. list_issue_discussions - List discussions for an issue in a GitLab project
  27. get_issue_link - Get a specific issue link
  28. create_issue_link - Create an issue link between two issues
  29. delete_issue_link - Delete an issue link
  30. list_namespaces - List all namespaces available to the current user
  31. get_namespace - Get details of a namespace by ID or path
  32. verify_namespace - Verify if a namespace path exists
  33. get_project - Get details of a specific project
  34. list_projects - List projects accessible by the current user
  35. list_labels - List labels for a project
  36. get_label - Get a single label from a project
  37. create_label - Create a new label in a project
  38. update_label - Update an existing label in a project
  39. delete_label - Delete a label from a project
  40. list_group_projects - List projects in a GitLab group with filtering options
  41. list_wiki_pages - List wiki pages in a GitLab project
  42. get_wiki_page - Get details of a specific wiki page
  43. create_wiki_page - Create a new wiki page in a GitLab project
  44. update_wiki_page - Update an existing wiki page in a GitLab project
  45. delete_wiki_page - Delete a wiki page from a GitLab project
  46. get_repository_tree - Get the repository tree for a GitLab project (list files and directories)
  47. list_pipelines - List pipelines in a GitLab project with filtering options
  48. get_pipeline - Get details of a specific pipeline in a GitLab project
  49. list_pipeline_jobs - List all jobs in a specific pipeline
  50. get_pipeline_job - Get details of a GitLab pipeline job number
  51. get_pipeline_job_output - Get the output/trace of a GitLab pipeline job number
  52. create_pipeline - Create a new pipeline for a branch or tag
  53. retry_pipeline - Retry a failed or canceled pipeline
  54. cancel_pipeline - Cancel a running pipeline
  55. list_merge_requests - List merge requests in a GitLab project with filtering options
  56. list_milestones - List milestones in a GitLab project with filtering options
  57. get_milestone - Get details of a specific milestone
  58. create_milestone - Create a new milestone in a GitLab project
  59. edit_milestone - Edit an existing milestone in a GitLab project
  60. delete_milestone - Delete a milestone from a GitLab project
  61. get_milestone_issue - Get issues associated with a specific milestone
  62. get_milestone_merge_requests - Get merge requests associated with a specific milestone
  63. promote_milestone - Promote a milestone to the next stage
  64. get_milestone_burndown_events - Get burndown events for a specific milestone
  65. get_users - Get GitLab user details by usernames
-
security - not tested
A
license - permissive license
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An MCP server that enables communication with GitLab repositories, allowing interaction with GitLab's API to manage projects, issues, and repositories through natural language.

  1. Installation and Execution
    1. Installing via Smithery
    2. Manual Installation
  2. Environment Variable Configuration
    1. License
      1. How to use
        1. Using with Claude App, Cline, Roo Code
          1. Using with Cursor

            Related MCP Servers

            • A
              security
              A
              license
              A
              quality
              MCP Server for the GitLab API, enabling project management, file operations, and more.
              Last updated -
              1,673
              66,283
              MIT License
              • Linux
              • Apple
            • A
              security
              F
              license
              A
              quality
              MCP server for managing Git operations on local repositories, allowing users to list repositories, get and create tags, list commits, push tags, and refresh repositories through a standardized interface.
              Last updated -
              6
              3
            • A
              security
              A
              license
              A
              quality
              An MCP server that enables analyzing and querying GitHub repositories through the GitHub Chat API, allowing users to index repositories and ask questions about their code, architecture and tech stack.
              Last updated -
              2
              60
              MIT License
              • Linux
              • Apple
            • A
              security
              A
              license
              A
              quality
              基于MCP框架构建的GitLab集成服务器,提供多种GitLab RESTful API工具,支持项目搜索、任务管理、合并请求创建与审核等功能,帮助开发团队高效协作。
              Last updated -
              8
              10
              3
              MIT License

            View all related MCP servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/harshmaur/gitlab-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server