Custom GitLab MCP Server

What is Custom GitLab MCP Server?

This server is a custom implementation of the GitLab MCP (Model Context Protocol) server for integration with Claude and other MCP-compliant AI assistants. It fixes schema validation issues present in the standard GitLab MCP server and enables AI assistants to search repositories, fetch file contents, create/update files, push multiple files in a single commit, create issues and merge requests, fork repositories, and create branches.

How to use Custom GitLab MCP Server?

Clone the repository, run npm install to install dependencies, then configure the server in your Claude settings file or Claude Desktop config under the mcpServers key with the GITLAB_PERSONAL_ACCESS_TOKEN and GITLAB_API_URL environment variables.

Key features of Custom GitLab MCP Server

• Search for GitLab projects
• Get file or directory contents
• Create or update a single file
• Push multiple files in one commit
• Create new GitLab projects
• Create issues and merge requests

Use cases of Custom GitLab MCP Server

• Search GitLab repositories from an AI assistant
• Retrieve file contents for analysis or editing
• Create or update files in a GitLab repository
• Push multiple files in a single commit via AI
• Create issues and merge requests programmatically

FAQ from Custom GitLab MCP Server

What does this custom server fix?

It fixes schema validation issues with the search_repositories tool that were present in the standard GitLab MCP server implementation.

What are the prerequisites for using Custom GitLab MCP Server?

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

How do I configure Custom GitLab MCP Server?

Add it to your Claude settings file under mcpServers with the command to run the server using Node.js and provide the environment variables GITLAB_PERSONAL_ACCESS_TOKEN and GITLAB_API_URL.

What tools does Custom GitLab MCP Server provide?

It offers nine tools: search_repositories, get_file_contents, create_or_update_file, push_files, create_repository, create_issue, create_merge_request, fork_repository, and create_branch.

What environment variables are required?

GITLAB_PERSONAL_ACCESS_TOKEN for authentication and GITLAB_API_URL pointing to your GitLab instance's API endpoint (e.g., https://your-gitlab-instance/api/v4).