Connects Gemini CLI to the GitLab-hosted Model Context Protocol (MCP) server (https://gitlab.com/api/v4/mcp). Exposes tools for issues, MRs, pipelines, and search without a local Ruby runtime.
gemini extensions install https://github.com/GitLab-Ecosystem/Gemini-CLI-Extensions
# or for local development: gemini extensions link .Restart Gemini CLI after installing/linking.
- GitLab SaaS account with
mcp_serverandoauth_dynamic_client_generationflags enabled. - Gemini CLI v0.8.0+.
- Node.js 20+ (for
npx).
First run requires browser authorization for the "MCP CLI Proxy" app.
Maps custom commands to MCP tools (defined in commands/*.toml):
/gitlab:issue <project> <iid>/gitlab:create-issue <project> | <title> | [desc]/gitlab:mr <project> <iid>/gitlab:mr-changes,/gitlab:mr-commits,/gitlab:mr-pipelines/gitlab:pipeline-jobs <project> <id>/gitlab:search <scope> <query>/gitlab:server-version
- Manifest:
gemini-extension.json(definesnpx mcp-remote). - Commands:
commands/*.toml. - Build:
npm install && npm run build(required for standard structure compliance). - Test:
npm test.
This repo follows the Gemini CLI extension releasing guidelines. The gemini-extension.json manifest lives at the repository root so users can install directly with gemini extensions install benvenker/gitlab-gemini-extension or by referencing specific branches/tags using --ref.
Apache 2.0