Back to the catalog

gitlab

Connects Gemini CLI to the hosted GitLab MCP server for issues, merge requests, and pipeline insights.

Open source Open in the app JSON README (API)

About

Connects Gemini CLI to the hosted GitLab MCP server for issues, merge requests, and pipeline insights.

Details

Kind
Plugins
Topic
Version control
Publisher
gitlab-ecosystem
Origin
gemini
Category
ferramentas
Version
0.1.0
Stars
15
Forks
3
Open pull requests
1
Last push
2026-04-16T13:28:29Z
Repository state
ativo
Language
TypeScript
Added
2026-08-30 14:13:39
Updated
2026-08-30 14:13:39
Origin id
gitlab-ecosystem/gemini-cli-extensions

README

# GitLab MCP Extension for Gemini CLI

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.

## Installation

```bash
gemini extensions install https://github.com/GitLab-Ecosystem/Gemini-CLI-Extensions
# or for local development: gemini extensions link .
```
*Restart Gemini CLI after installing/linking.*

## Prerequisites
- **GitLab SaaS** account with `mcp_server` and `oauth_dynamic_client_generation` flags enabled.
- **Gemini CLI** v0.8.0+.
- **Node.js** 20+ (for `npx`).

*First run requires browser authorization for the "MCP CLI Proxy" app.*

## Commands
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:create-mr <project> | <title> | <source_branch> | <target_branch>`
- `/gitlab:mr-changes`, `/gitlab:mr-commits`, `/gitlab:mr-pipelines`
- `/gitlab:pipeline-jobs <project> <id>`, `/gitlab:manage-pipeline`
- `/gitlab:create-note <work_item_url> <body>`, `/gitlab:workitem-notes <work_item_url>`
- `/gitlab:search <scope> <query>`, `/gitlab:semantic-search <project> <query>`
- `/gitlab:search-labels <full_path> <is_project> [search]`
- `/gitlab:server-version`

## Development

- **Manifest**: `gemini-extension.json` (defines `npx mcp-remote`).
- **Commands**: `commands/*.toml`.
- **Build**: `npm install && npm run build` (required for standard structure compliance).
- **Test**: `npm test`.


## Distribution
This repo follows the Gemini CLI [extension releasing](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension-releasing.md) 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`.

## License
Apache 2.0

More