zereight/gitlab-mcp (via mcp2cli)
Manage GitLab projects, merge requests, issues, pipelines, and releases via CLI.
Shortcuts
mcp2cli gitlab <cmd>(server alias)
Commands
Merge Requests
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli gitlab mr create |
Create a new MR | mcp2cli gitlab mr create --title "Fix bug" --source-branch feature/fix --target-branch main |
ref |
mcp2cli gitlab mr get |
Get MR details | mcp2cli gitlab mr get --project-id my-group/my-repo --merge-request-iid 42 |
ref |
mcp2cli gitlab mr list |
List merge requests | mcp2cli gitlab mr list --project-id my-group/my-repo |
ref |
mcp2cli gitlab mr update |
Update a merge request | ref | |
mcp2cli gitlab mr merge |
Merge a merge request | mcp2cli gitlab mr merge --project-id my-group/my-repo --merge-request-iid 42 |
ref |
mcp2cli gitlab mr diff get |
Get MR full diff | ref | |
mcp2cli gitlab mr diff changed-files |
List changed file paths | mcp2cli gitlab mr diff changed-files --project-id my-group/repo --merge-request-iid 42 |
ref |
mcp2cli gitlab mr approval approve |
Approve a merge request | ref |
Issues
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli gitlab issue create |
Create a new issue | mcp2cli gitlab issue create --title "Fix memory leak" --project-id my-group/my-repo |
ref |
mcp2cli gitlab issue get |
Get issue details | mcp2cli gitlab issue get --project-id my-group/my-repo --issue-iid 10 |
ref |
mcp2cli gitlab issue list |
List issues | mcp2cli gitlab issue list --project-id my-group/my-repo |
ref |
mcp2cli gitlab issue my |
List my assigned issues | mcp2cli gitlab issue my |
ref |
mcp2cli gitlab issue update |
Update an issue | ref | |
mcp2cli gitlab issue delete |
Delete an issue | ref |
Repositories & Files
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli gitlab repo search |
Search for projects | mcp2cli gitlab repo search --search my-project |
ref |
mcp2cli gitlab repo get |
Get project details | mcp2cli gitlab repo get --project-id my-group/my-repo |
ref |
mcp2cli gitlab repo create |
Create a new project | mcp2cli gitlab repo create --name my-new-repo --visibility private |
ref |
mcp2cli gitlab repo file get |
Get file contents | mcp2cli gitlab repo file get --project-id my-group/my-repo --file-path src/main.go |
ref |
mcp2cli gitlab repo file update |
Create or update a file | ref | |
mcp2cli gitlab repo tree |
List files/dirs in repo | ref |
Pipelines & CI
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli gitlab pipeline list |
List pipelines | mcp2cli gitlab pipeline list --project-id my-group/my-repo |
ref |
mcp2cli gitlab pipeline get |
Get pipeline details | ref | |
mcp2cli gitlab pipeline create |
Trigger a new pipeline | ref | |
mcp2cli gitlab pipeline retry |
Retry a pipeline | ref | |
mcp2cli gitlab pipeline job output |
Get job log output | ref | |
mcp2cli gitlab pipeline job list |
List pipeline jobs | ref |
Releases & Other
| Command | Description | Example | Ref |
|---|---|---|---|
mcp2cli gitlab release create |
Create a release | ref | |
mcp2cli gitlab release list |
List releases | ref | |
mcp2cli gitlab milestone create |
Create a milestone | ref | |
mcp2cli gitlab wiki create |
Create a wiki page | ref | |
mcp2cli gitlab deployment list |
List deployments | ref | |
mcp2cli gitlab branch create |
Create a branch | ref |
Discover Parameters
Append --help to any command for full parameter list:
mcp2cli gitlab mr create --help
Note: Use Ref links in the Commands table above for detailed parameter reference and more examples.
User Notes
MUST READ users/skill.md for custom workflows and tips. Config: MCP server settings live in
~/.agents/mcp2cli/servers.yaml- edit there to take effect.