I love GitLab so much I built a whole MCP server for it. Now my AI assistant manages my merge requests, and honestly, it reviews code faster than my teammates. You're welcome. — Allan Mugarura, creator

Tools (25)

| Category | Tools | |----------|-------| | Projects | list_projects, get_project | | Issues | list_issues, get_issue, create_issue, update_issue, comment_on_issue | | Merge Requests | list_merge_requests, get_merge_request, create_merge_request, get_merge_request_changes, comment_on_merge_request, approve_merge_request, merge_merge_request | | Pipelines | list_pipelines, get_pipeline, list_pipeline_jobs, retry_pipeline | | Repository | list_branches, create_branch, get_file, list_tree, create_or_update_file | | Users | get_current_user, search_users |

Quick Start

1. Get a GitLab Personal Access Token

Go to GitLab → Settings → Access Tokens and create a token with the api scope.

2. Install

npm install -g @masuratech/gitlab-mcp-server

Or clone and build from source:

git clone https://gitlab.com/masuratech/gitlab-mcp-server.git
cd gitlab-mcp-server
npm install
npm run build

3. Register with Claude Code

claude mcp add gitlab \
  --env GITLAB_PERSONAL_ACCESS_TOKEN=glpat-xxxxx \
  -- npx @masuratech/gitlab-mcp-server

Or if built from source:

claude mcp add gitlab \
  --env GITLAB_PERSONAL_ACCESS_TOKEN=glpat-xxxxx \
  -- node /path/to/gitlab-mcp-server/dist/index.js

4. Use

Start a Claude Code session and ask things like:

• "List my GitLab projects"
• "Show open merge requests in mygroup/myrepo"
• "Create an issue titled 'Fix login bug' in project 123"
• "What's the status of the latest pipeline?"

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | GITLAB_PERSONAL_ACCESS_TOKEN | Yes | — | Your GitLab PAT with api scope | | GITLAB_API_URL | No | https://gitlab.com/api/v4 | Custom GitLab instance URL |

Self-hosted GitLab

claude mcp add gitlab \
  --env GITLAB_PERSONAL_ACCESS_TOKEN=glpat-xxxxx \
  --env GITLAB_API_URL=https://gitlab.yourcompany.com/api/v4 \
  -- npx @masuratech/gitlab-mcp-server

Development

npm install
npm run dev    # watch mode
npm run build  # one-shot compile
npm start      # run the server

Support

I gave you 25 tools for free. All I'm asking for is one dollar. One. That's less than the mass-produced coffee you're drinking right now. Come on.

License

MIT — Masura Tech Ltd

Built with love (and mass-produced coffee) in Kampala by Masura Tech.