home / mcp / gitlab jira mcp server

GitLab Jira MCP Server

gitlab jira mcp

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ashabbir-multi-mcp": {
      "command": "mcp-gitlab-jira",
      "args": [],
      "env": {
        "JIRA_URL": "<token>?",
        "GITLAB_URL": "<token>?",
        "JIRA_TOKEN": "<token>?",
        "GITLAB_TOKEN": "<token>?"
      }
    }
  }
}

You run a lightweight MCP server that exposes GitLab and Jira data to MCP-enabled clients. It focuses on safe, read-only access in MVP mode, with easy setup via environment variables or a small JSON config and a modular design that’s ready for future expansion.

How to use

Use an MCP-enabled client to interact with GitLab and Jira data through the MCP server. You can discover available tools, request project data, list merge requests, fetch issues, and search Jira issues. The server handles input validation, safely communicates with upstream APIs, and returns sanitized results. You’ll invoke tools like gitlab_list_projects, gitlab_list_merge_requests, gitlab_list_issues, jira_search_issues, and jira_get_issue to access data across your GitLab and Jira instances.

How to install

Follow these steps to install and run the MCP server locally.

make install
make build
make run

Configuration and security

Configure the server using environment variables or a JSON config file. The required environment variables are the endpoints and credentials for your GitLab and Jira instances. You can provide them as: - GITLAB_URL, GITLAB_TOKEN - JIRA_URL, JIRA_TOKEN Or via a JSON config file at ~/.mcp-gitlab-jira.json with the same structure as shown below.

{
  "gitlab": { "url": "https://gitlab.com", "token": "<token>" },
  "jira": { "url": "https://company.atlassian.net", "token": "<email:api_token>" }
}

MCP client configuration

Add the MCP server to your client configuration so you can call the available tools. An example entry uses a local, stdio-based server command.

{
  "servers": {
    "gitlab-jira": {
      "command": "mcp-gitlab-jira"
    }
  }
}

Available tools

gitlab_list_projects

List projects accessible with the provided GitLab token.

gitlab_list_merge_requests

List merge requests for a given project, with optional state filtering.

gitlab_list_issues

List issues for a given project.

jira_search_issues

Search Jira issues using JQL with optional maxResults.

jira_get_issue

Fetch a Jira issue by key.