How to connect Gitlab MCP with Cursor

How to integrate Gitlab MCP with Cursor Cursor is one of the leading AI-powered code editors. It is built to help developers write, understand, and refactor code faster with AI assistance built directly into the editor. And in this guide, I will explain the easiest and most secure way to connect your Gitlab account to Cursor via Composio Connect, so it can create new GitLab group for QA team, open bug issue in frontend project, create branch from latest main commit, and more without ever putting your account credentials at risk.

Get started for free Get a demo

Gitlab

Oauth2

Gitlab is a web-based DevOps platform for managing source code, issues, and CI/CD pipelines. It streamlines software development with integrated collaboration and automation tools.

58 Tools

Managed auth

Connect Gitlab without auth hassles

We manage OAuth, API keys, token refresh, and scopes — you just build.

Try for free

How to integrate Gitlab MCP with Cursor

Cursor is one of the leading AI-powered code editors. It is built to help developers write, understand, and refactor code faster with AI assistance built directly into the editor.

And in this guide, I will explain the easiest and most secure way to connect your Gitlab account to Cursor via Composio Connect, so it can create new GitLab group for QA team, open bug issue in frontend project, create branch from latest main commit, and more without ever putting your account credentials at risk.

Also integrate Gitlab with

ChatGPT OpenAI Agents SDK Claude Agent SDK Claude Code Claude Cowork Codex OpenCode VS Code OpenClaw Hermes CLI Google ADK LangChain Vercel AI SDK Mastra AI LlamaIndex CrewAI

Why Composio?

1,000+ SaaS toolkits out of the box. Skip the work of building and maintaining integrations, Composio gives you instant access to a vast catalog of pre-built connectors.
One MCP server for every app. Connect any of your applications on demand through a single endpoint, rather than juggling a separate server for each app.
Smart, context-aware tool loading. Unlike traditional MCP servers that dump every available tool into the LLM context window, Composio searches for and loads only the tools relevant to the task at hand. A remote CLI workbench lets LLMs compose these tools into workflows for complex automation.

Connect Gitlab to Cursor

Two ways to install — pick whichever you prefer.

1. Install with one click

Click the button below to add Composio to Cursor.

↗Install in Cursor

2. Or add manually

Add to your Cursor mcp.json

Open .cursor/mcp.json in your project root (or ~/.cursor/mcp.json for global config) and add the following configuration:

bash

{
  "servers": {
    "composio": {
      "type": "http",
      "url": "https://connect.composio.dev/mcp"
    }
  }
}

3. Authorize

Restart Cursor, then click "Connect" next to Composio in MCP Tools settings.

Cursor MCP Tools settings with Connect button next to Composio

A browser window will open to authorize.

Connect your Gitlab account

Back in Cursor, ask the agent to connect to Gitlab or give it any Gitlab-related task.

For example, ask it to:

"Create new GitLab group for QA team"
"Open bug issue in frontend project"
"Create branch from latest main commit"

It will prompt you to authenticate and authorize access to Gitlab.

That is it. Composio tools are now available in Cursor, and your Gitlab account is ready to use.

Conclusion

You have successfully connected Gitlab to Cursor using Composio Connect. Your agent can now use Gitlab securely without exposing credentials in prompts or local scripts.

TOOLS

Supported Tools

Every Gitlab action and event your agent gets out of the box.

Archive Project

Tool to archive a project.

Create GitLab Group

Tool to create a new group in GitLab.

Create Project

Tool to create a new project in GitLab.

Create Project Issue

Tool to create a new issue in a GitLab project.

Create Repository Branch

Tool to create a new branch in a project.

Delete Project

Tool to delete a GitLab project by its ID.

Download Project Avatar

Tool to download a project's avatar image.

Erase Job

Tool to erase the content of a specified job within a project.

Get Commit References

Tool to get all references (branches or tags) a commit is pushed to.

Get Commit Sequence

Tool to get the sequence number of a commit in a project by following parent links from the given commit.

Get Group Details

Tool to retrieve information about a specific group by its ID.

Get Group Member

Tool to retrieve details for a specific group member.

Get Groups

Get Job Details

Tool to retrieve details of a single job by its ID within a specified project.

Get Merge Request Notes

Tool to fetch comments on a merge request.

Get Project

Tool to get a single project by ID or URL-encoded path.

Get Project Languages

Tool to list programming languages used in a project with percentages.

Get Project Member

Tool to retrieve details for a specific project member.

Get Project Member All

Tool to retrieve details for a specific project member (including inherited and invited members).

Get Project Merge Request

Tool to fetch full details for a single merge request when the MR IID is known.

Get Merge Request Commits

Tool to get commits of a merge request.

Get Project Merge Requests

Tool to retrieve a list of merge requests for a specific project.

Get Projects

Tool to list all projects accessible to the authenticated user.

List Merge Request Diffs

Tool to list all diff versions of a merge request.

Get Repository Branch

Tool to retrieve information about a specific branch in a project.

Get Repository Branches

Retrieves a list of repository branches for a project.

Get Single Commit

Tool to get a specific commit identified by the commit hash or name of a branch or tag.

Get Single Pipeline

Tool to retrieve details of a single pipeline by its ID within a specified project.

Get User

Tool to retrieve information about a specific user by their ID.

Get User Preferences

Tool to get the current user's preferences.

Get Users

Tool to retrieve a list of users from GitLab.

Get User Status

Tool to get a user's status by ID.

Get User Status

Tool to get the current user's status.

Get User Support PIN

Tool to get details of the current user's Support PIN.

Import project members

Tool to import members from one project to another.

List All Group Members

Tool to list all members of a group including direct, inherited, and invited members.

List All Project Members

Tool to list all members of a project (direct, inherited, invited).

List Billable Group Members

Tool to list billable members of a top-level group (including its subgroups and projects).

List Group Members

Tool to list direct members of a group.

List Group Projects

Tool to list projects within a GitLab group by group ID or full path.

List Pending Group Members

Tool to list pending members of a group and its subgroups and projects.

List Pipeline Jobs

Tool to retrieve a list of jobs for a specified pipeline within a project.

List Project Groups

Tool to list ancestor groups of a project.

List Project Invited Groups

Tool to list groups invited to a project.

List Project Issues

Tool to list issues for a project with filtering options (state, labels, search, assignee, author, etc.

List Project Pipelines

Tool to retrieve a list of pipelines for a specified project.

List Project Shareable Groups

Tool to list groups that can be shared with a project.

List Project Repository Tags

Tool to retrieve a list of repository tags for a specified project.

List Project Transfer Locations

Tool to list namespaces available for project transfer.

List project users

Tool to list users of a project.

List Repository Commits

Tool to get a list of repository commits in a project.

List User Projects

Tool to list projects owned by a specific user.

Create Support PIN

Tool to create a support PIN for your authenticated user.

Update User Preferences

Tool to update the current user's preferences.

Set User Status

Tool to set the current user's status.

Share Project With Group

Tool to share a project with a group.

Start Housekeeping Task

Tool to start the housekeeping task for a project.

Update Project Issue

Tool to update an existing issue in a GitLab project (title, description, labels, assignees, state, etc.

FRAMEWORKS

How to build Gitlab MCP Agent with another framework

ChatGPT

Use Gitlab MCP with ChatGPT

OpenAI Agents SDK

Use Gitlab MCP with OpenAI Agents SDK

Claude Agent SDK

Use Gitlab MCP with Claude Agent SDK

Claude Code

Use Gitlab MCP with Claude Code

Claude Cowork

Use Gitlab MCP with Claude Cowork

Codex

Use Gitlab MCP with Codex

OpenClaw

Use Gitlab MCP with OpenClaw

Hermes

Use Gitlab MCP with Hermes

CLI

Use Gitlab MCP with CLI

Google ADK

Use Gitlab MCP with Google ADK

LangChain

Use Gitlab MCP with LangChain

Vercel AI SDK

Use Gitlab MCP with Vercel AI SDK

Mastra AI

Use Gitlab MCP with Mastra AI

LlamaIndex

Use Gitlab MCP with LlamaIndex

CrewAI

Use Gitlab MCP with CrewAI

OpenCode

Use Gitlab MCP with OpenCode

VS Code

Use Gitlab MCP with VS Code

MORE TOOLKITS

Explore Other Toolkits

Toolkit marketplace

Supabase

Oauth2Api Key

Supabase is an open-source backend platform offering scalable Postgres databases, authentication, storage, and real-time APIs. It lets developers build modern apps without managing infrastructure.

Codeinterpreter

No Auth

Codeinterpreter is a Python-based coding environment with built-in data analysis and visualization. It lets you instantly run scripts, plot results, and prototype solutions inside supported platforms.

GitHub

Oauth2

GitHub is a code hosting platform for version control and collaborative software development. It streamlines project management, code review, and team workflows in one place.

Ably

Api Key

Ably is a real-time messaging platform for live chat and data sync in modern apps. It offers global scale and rock-solid reliability for seamless, instant experiences.

FAQ

Frequently asked questions

With a standalone Gitlab MCP server, the agents and LLMs can only access a fixed set of Gitlab tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Gitlab and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Cursor fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Gitlab tools.

Yes, absolutely. You can configure which Gitlab scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Gitlab data and credentials are handled as safely as possible.

Start with Gitlab.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Gitlab tool your agent needs.Free to start.

Start building

Customer stories

Teams ship real agents on Composio

GET STARTED FOR FREE BOOK A DEMO

Karan skipped his own birthday party to fix our critical issue. It was 10pm and he diverted his Waymo to help us instead. This really sets the bar — it shows the commitment you need when users rely on your software.

Harsha Gaddipati

Co-founder, Slashy

A lot of students tell us that the moment their connected tools start talking to each other inside Opennote feels almost magical. The agent just knows them, and it's immensely helped keep new users on the platform.

Abhi Arya

Co-founder, Opennote

We chose Composio over Pipedream because it delivered depth where it mattered — niche tools and tricky edge cases other platforms simply ignored. That gave us confidence to scale without compromising.

Nirman Dave

CEO, Zams

As a solo builder, shipping fast is life or death. The only way I can outcompete incumbents is by outmanoeuvring them. Getting bogged down managing agent auth would have been a death sentence.

Ryan Yu

Founder, Extra Thursday

Before Composio, adding tool integrations was slow and resource-intensive. Each one could take weeks of engineering time, and maintaining them meant constantly keeping up with API changes.

Tomisin Jenrola

Founder & CEO, SwarmZero

With hands-on help from their founder, we integrated Gmail and Google Drive in just 30 minutes. This level of personal support and commitment is exactly what startups should strive for.

Jerome Leclanche

Co-Founder, Ingram Technologies