Custom Gitlab MCP Server

Custom GitLab MCP Server implementation

Local serverstdio

What is the Custom Gitlab MCP Server?

Custom GitLab MCP Server implementation

What it actually does

A custom implementation of the GitLab MCP (Model Context Protocol) server for integration with Claude and other MCP-compliant AI assistants.

This MCP server provides seamless integration with GitLab repositories, allowing AI assistants to: - Search GitLab repositories - Fetch file contents - Create or update files - Push multiple files in a single commit - Create issues and merge requests - Fork repositories - Create branches

Configuration

  • Node.js (v14 or higher) - GitLab Personal Access Token with appropriate scopes: - api for full API access - read_api for read-only access - read_repository and write_repository for repository operations

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
search_repositoriesSearch for GitLab projects
get_file_contentsGet contents of a file or directory
create_or_update_fileCreate or update a single file
push_filesPush multiple files in a single commit
create_repositoryCreate a new GitLab project
create_issueCreate a new issue
create_merge_requestCreate a new merge request
fork_repositoryFork a project
create_branchCreate a new branch

How to install the Custom Gitlab MCP Server

{
  "mcpServers": {
    "github.com/modelcontextprotocol/servers/tree/main/src/gitlab": {
      "command": "node",
      "args": [
        "/path/to/custom-gitlab-server/index.js"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_PERSONAL_ACCESS_TOKEN",
        "GITLAB_API_URL": "https://your-gitlab-instance/api/v4"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  • Node.js (v14 or higher) - GitLab Personal Access Token with appropriate scopes: - api for full API access - read_api for read-only access - read_repository and write_repository for repository operations
VariableDescriptionRequired
GITLAB_PERSONAL_ACCESS_TOKENDeclared in the maintainer’s client configuration.Check documentation
GITLAB_API_URLDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Custom Gitlab to search repositories.”
  • “Use Custom Gitlab to get file contents.”
  • “Use Custom Gitlab to create or update file.”

Frequently asked questions

Custom GitLab MCP Server implementation Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.