productivity
GitLab MCP, CLI, and Lua Integration for AI Agents
GitLab integration docs for AI agents: MCP gateway setup, GitLab CLI commands, Lua API reference, credentials, and function schemas.
20 functions 13 read 7 write API token auth
GitLab for agents
Credentials can be configured manually in web or CLI hosts.
Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.
Machine-Readable Metadata
- integration_slug
gitlab- route_slug
gitlab- package
gitlab- auth_strategy
api_tokenAPI token- cli_setup_supported
true- cli_runtime_supported
true- mcp_gateway_supported
true- lua_supported
true- supports_multi_account
true
Quick Links
Lua APIAgent-facing namespace and function reference. GitLab CLIHeadless setup and direct function calls. GitLab MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.
GitLab MCP Client Matrix
Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for GitLab.
Claude Code GitLab MCP setup for Claude Code. Cursor GitLab MCP setup for Cursor. Codex GitLab MCP setup for Codex. OpenAI Agents GitLab MCP setup for OpenAI Agents SDK. Claude Agent SDK GitLab MCP setup for Claude Agent SDK. Vercel AI SDK GitLab MCP setup for Vercel AI SDK. LangChain GitLab MCP setup for LangChain. LangGraph GitLab MCP setup for LangGraph. CrewAI GitLab MCP setup for CrewAI. MCP clients GitLab MCP setup for Generic MCP Clients.
GitLab CLI Matrix
Use these pages for direct GitLab CLI workflows in scripts, CI, cron, and agent wrappers.
CI GitLab CLI for CI. Cron Jobs GitLab CLI for cron jobs. Shell Scripts GitLab CLI for shell scripts. Headless Automation GitLab CLI for headless automation. Coding Agents GitLab CLI for coding agents.
Function Catalog
| Function | Type | Parameters | Description |
|---|---|---|---|
gitlab.gitlab_create_issue | Write write | 7 | Create a new issue in a GitLab project. Requires a project ID and title. Optionally set description, labels, assignees, milestone, and weight. |
gitlab.gitlab_get_issue | Read read | 2 | Get detailed information about a specific GitLab issue, including title, description, labels, assignees, milestone, and state. |
gitlab.gitlab_update_issue | Write write | 7 | Update an existing issue in a GitLab project. Can change title, description, labels, state (close/reopen), and assignees. |
gitlab.gitlab_list_issues | Read read | 6 | List issues in a GitLab project. Supports filtering by state (opened, closed, all), labels, and search text. Paginated. |
gitlab.gitlab_search_issues | Read read | 3 | Search for issues in a GitLab project by keyword. Searches issue titles and descriptions. Optionally filter by state. |
gitlab.gitlab_create_issue_comment | Write write | 3 | Add a comment (note) to a GitLab issue. The comment body supports GitLab Markdown. |
gitlab.gitlab_create_merge_request | Write write | 6 | Create a new merge request in a GitLab project. Requires source branch, target branch, and title. |
gitlab.gitlab_get_merge_request | Read read | 2 | Get detailed information about a specific GitLab merge request, including title, description, source/target branches, and state. |
gitlab.gitlab_list_merge_requests | Read read | 4 | List merge requests in a GitLab project. Supports filtering by state (opened, closed, merged, all). Paginated. |
gitlab.gitlab_update_merge_request | Write write | 6 | Update an existing merge request in a GitLab project. Can change title, description, labels, and state (close/reopen). |
gitlab.gitlab_accept_merge_request | Write write | 3 | Accept (merge) a GitLab merge request. Optionally set a custom merge commit message. |
gitlab.gitlab_list_branches | Read read | 3 | List branches in a GitLab project repository. Supports searching by branch name and pagination. |
gitlab.gitlab_create_branch | Write write | 3 | Create a new branch in a GitLab project repository. Requires a branch name and a ref (branch name or commit SHA) to create from. |
gitlab.gitlab_list_commits | Read read | 4 | List commits in a GitLab project repository. Supports filtering by branch or tag name. Paginated. |
gitlab.gitlab_get_file | Read read | 3 | Get a file from a GitLab project repository. Returns file content (base64-encoded), file name, size, and encoding. |
gitlab.gitlab_list_projects | Read read | 4 | List GitLab projects visible to the authenticated user. Supports filtering by membership, search text, and pagination. |
gitlab.gitlab_get_project | Read read | 1 | Get details for a specific GitLab project, including name, description, default branch, visibility, and statistics. |
gitlab.gitlab_list_groups | Read read | 2 | List GitLab groups visible to the authenticated user. Paginated. |
gitlab.gitlab_list_project_members | Read read | 2 | List members of a GitLab project and their access levels. Paginated. |
gitlab.gitlab_list_labels | Read read | 1 | List all labels for a GitLab project, including name, color, description, and open/closed issue counts. |