Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 27 additions & 2 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](./LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 64 CQRS tools exposing 234 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server: 64 CQRS tools exposing 235 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-12.0.3.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
Expand Down Expand Up @@ -34,6 +34,31 @@ This is a monorepo with two npm packages:

**Requirements:** Node.js >= 24

## Supported clients

| Client | Setup |
|--------|-------|
| **Codex (CLI and desktop)** | [Local MCP registration or remote HTTP server](https://gitlab-mcp.sw.foundation/guide/installation/codex) |
| **Antigravity CLI (`agy`)** | [Workspace MCP configuration and tested compatibility](https://gitlab-mcp.sw.foundation/clients/antigravity) |
| Claude Desktop | [Desktop extension or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-desktop) |
| Claude Code | [CLI or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-code) |
| VS Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/vscode) |
| Cursor | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cursor) |
| Windsurf | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/windsurf) |
| Cline | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cline) |
| Roo Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/roo-code) |

With the Codex CLI installed and `GITLAB_API_URL` and `GITLAB_TOKEN` set in your
environment, run `npx @structured-world/gitlab-mcp install --codex` to register a
local server. For Antigravity, add the server
to `.agents/mcp_config.json` in your workspace. Follow the linked guides for
authentication, remote-server setup and client-specific configuration.

Codex and Claude Code can be configured side by side. Antigravity CLI 1.4.10 is
qualified against the installed core package on macOS and Linux, including empty
and single-MR lists. See the [client overview](https://gitlab-mcp.sw.foundation/clients/)
for all setup guides.

## Highlights

- **64 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
Expand All @@ -52,7 +77,7 @@ This is a monorepo with two npm packages:
GitLab exposes hundreds of API operations. Giving each its own MCP tool floods an
agent's context; a thin API wrapper pushes that complexity back onto the agent. This
server takes a third path: 64 CQRS tools, each holding several typed
actions, expose 234 operations across 26 entity types.
actions, expose 235 operations across 26 entity types.

- `browse_*` tools are read-only queries; `manage_*` tools are writes.
- Sub-resources fold into actions rather than new tools — `browse_pipelines` covers
Expand Down
29 changes: 27 additions & 2 deletions packages/gitlab-mcp-db/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/structured-world/gitlab-mcp/blob/HEAD/LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 64 CQRS tools exposing 234 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server: 64 CQRS tools exposing 235 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-12.0.3.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
Expand Down Expand Up @@ -34,6 +34,31 @@ This is a monorepo with two npm packages:

**Requirements:** Node.js >= 24

## Supported clients

| Client | Setup |
|--------|-------|
| **Codex (CLI and desktop)** | [Local MCP registration or remote HTTP server](https://gitlab-mcp.sw.foundation/guide/installation/codex) |
| **Antigravity CLI (`agy`)** | [Workspace MCP configuration and tested compatibility](https://gitlab-mcp.sw.foundation/clients/antigravity) |
| Claude Desktop | [Desktop extension or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-desktop) |
| Claude Code | [CLI or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-code) |
| VS Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/vscode) |
| Cursor | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cursor) |
| Windsurf | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/windsurf) |
| Cline | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cline) |
| Roo Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/roo-code) |

With the Codex CLI installed and `GITLAB_API_URL` and `GITLAB_TOKEN` set in your
environment, run `npx @structured-world/gitlab-mcp install --codex` to register a
local server. For Antigravity, add the server
to `.agents/mcp_config.json` in your workspace. Follow the linked guides for
authentication, remote-server setup and client-specific configuration.

Codex and Claude Code can be configured side by side. Antigravity CLI 1.4.10 is
qualified against the installed core package on macOS and Linux, including empty
and single-MR lists. See the [client overview](https://gitlab-mcp.sw.foundation/clients/)
for all setup guides.

## Highlights

- **64 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
Expand All @@ -52,7 +77,7 @@ This is a monorepo with two npm packages:
GitLab exposes hundreds of API operations. Giving each its own MCP tool floods an
agent's context; a thin API wrapper pushes that complexity back onto the agent. This
server takes a third path: 64 CQRS tools, each holding several typed
actions, expose 234 operations across 26 entity types.
actions, expose 235 operations across 26 entity types.

- `browse_*` tools are read-only queries; `manage_*` tools are writes.
- Sub-resources fold into actions rather than new tools — `browse_pipelines` covers
Expand Down
27 changes: 26 additions & 1 deletion packages/gitlab-mcp/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://github.com/structured-world/gitlab-mcp/blob/HEAD/LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — 64 CQRS tools exposing 235 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server: 64 CQRS tools exposing 235 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-12.0.3.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
Expand Down Expand Up @@ -34,6 +34,31 @@ This is a monorepo with two npm packages:

**Requirements:** Node.js >= 24

## Supported clients

| Client | Setup |
|--------|-------|
| **Codex (CLI and desktop)** | [Local MCP registration or remote HTTP server](https://gitlab-mcp.sw.foundation/guide/installation/codex) |
| **Antigravity CLI (`agy`)** | [Workspace MCP configuration and tested compatibility](https://gitlab-mcp.sw.foundation/clients/antigravity) |
| Claude Desktop | [Desktop extension or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-desktop) |
| Claude Code | [CLI or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-code) |
| VS Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/vscode) |
| Cursor | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cursor) |
| Windsurf | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/windsurf) |
| Cline | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cline) |
| Roo Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/roo-code) |

With the Codex CLI installed and `GITLAB_API_URL` and `GITLAB_TOKEN` set in your
environment, run `npx @structured-world/gitlab-mcp install --codex` to register a
local server. For Antigravity, add the server
to `.agents/mcp_config.json` in your workspace. Follow the linked guides for
authentication, remote-server setup and client-specific configuration.

Codex and Claude Code can be configured side by side. Antigravity CLI 1.4.10 is
qualified against the installed core package on macOS and Linux, including empty
and single-MR lists. See the [client overview](https://gitlab-mcp.sw.foundation/clients/)
for all setup guides.

## Highlights

- **64 tools** across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
Expand Down
27 changes: 26 additions & 1 deletion packages/gitlab-mcp/README.md.in
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

[![npm version](https://img.shields.io/npm/v/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![npm downloads](https://img.shields.io/npm/dm/@structured-world/gitlab-mcp)](https://www.npmjs.com/package/@structured-world/gitlab-mcp) [![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](__REPO_BASE__/LICENSE) [![Release](https://github.com/structured-world/gitlab-mcp/workflows/Release/badge.svg)](https://github.com/structured-world/gitlab-mcp/actions) [![Coverage](https://codecov.io/gh/structured-world/gitlab-mcp/graph/badge.svg)](https://codecov.io/gh/structured-world/gitlab-mcp) [![Coverage Report](https://img.shields.io/badge/Coverage-Live%20Report-brightgreen?logo=github)](https://gitlab-mcp.sw.foundation/coverage/)

Advanced GitLab MCP server — __TOOL_COUNT__ CQRS tools exposing __ACTION_COUNT__ GitLab operations across __ENTITY_COUNT__ entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.
Advanced GitLab MCP server: __TOOL_COUNT__ CQRS tools exposing __ACTION_COUNT__ GitLab operations across __ENTITY_COUNT__ entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

[![Install in Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install_Extension-F97316?style=for-the-badge)](https://gitlab-mcp.sw.foundation/downloads/gitlab-mcp-__VERSION__.mcpb)
[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_MCP_Server-007ACC?style=for-the-badge&logo=visualstudiocode&logoColor=white)](vscode:mcp/install?%7B%22name%22%3A%22gitlab-mcp%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40structured-world%2Fgitlab-mcp%22%5D%7D)
Expand Down Expand Up @@ -34,6 +34,31 @@ This is a monorepo with two npm packages:

**Requirements:** Node.js >= 24

## Supported clients

| Client | Setup |
|--------|-------|
| **Codex (CLI and desktop)** | [Local MCP registration or remote HTTP server](https://gitlab-mcp.sw.foundation/guide/installation/codex) |
| **Antigravity CLI (`agy`)** | [Workspace MCP configuration and tested compatibility](https://gitlab-mcp.sw.foundation/clients/antigravity) |
| Claude Desktop | [Desktop extension or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-desktop) |
| Claude Code | [CLI or MCP configuration](https://gitlab-mcp.sw.foundation/clients/claude-code) |
| VS Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/vscode) |
| Cursor | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cursor) |
| Windsurf | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/windsurf) |
| Cline | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/cline) |
| Roo Code | [MCP configuration](https://gitlab-mcp.sw.foundation/clients/roo-code) |

With the Codex CLI installed and `GITLAB_API_URL` and `GITLAB_TOKEN` set in your
environment, run `npx @structured-world/gitlab-mcp install --codex` to register a
local server. For Antigravity, add the server
to `.agents/mcp_config.json` in your workspace. Follow the linked guides for
authentication, remote-server setup and client-specific configuration.

Codex and Claude Code can be configured side by side. Antigravity CLI 1.4.10 is
qualified against the installed core package on macOS and Linux, including empty
and single-MR lists. See the [client overview](https://gitlab-mcp.sw.foundation/clients/)
for all setup guides.

## Highlights

- **__TOOL_COUNT__ tools** across __ENTITY_COUNT__ entity types — projects, merge requests, pipelines, work items, wiki, and more
Expand Down
1 change: 1 addition & 0 deletions packages/gitlab-mcp/docs/.vitepress/config.mts
Original file line number Diff line number Diff line change
Expand Up @@ -306,6 +306,7 @@ export default defineConfig({
{ text: "Overview", link: "/clients/" },
{ text: "Claude Desktop", link: "/clients/claude-desktop" },
{ text: "Claude Code", link: "/clients/claude-code" },
{ text: "Antigravity CLI", link: "/clients/antigravity" },
{ text: "Cursor", link: "/clients/cursor" },
{ text: "VS Code", link: "/clients/vscode" },
{ text: "Windsurf", link: "/clients/windsurf" },
Expand Down
Loading
Loading