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

$3

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

#### npx

``json
{
"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
`mcp.json
{
"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
`shell
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
`

`json
{
"mcpServers": {
"GitLab communication server": {
"url": "http://localhost:3333/sse"
}
}
}
`

#### Docker Image Push

`shell
$ sh scripts/image_push.sh docker_user_name
`

$3

- 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