home / mcp / jira linear mcp server

Jira Linear MCP Server

MCP servers enabling Jira and Linear integrations for querying, creating, and reading issues through natural language commands.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "dxheroes-mcp-devtools": {
      "command": "env",
      "args": [
        "JIRA_URL=https://[YOUR_WORKSPACE].atlassian.net",
        "JIRA_API_MAIL=[YOUR_EMAIL]",
        "JIRA_API_KEY=[YOUR_API_KEY]",
        "npx",
        "-y",
        "@mcp-devtools/jira"
      ],
      "env": {
        "JIRA_URL": "https://[YOUR_WORKSPACE].atlassian.net",
        "JIRA_API_KEY": "[YOUR_API_KEY]",
        "JIRA_API_MAIL": "[YOUR_EMAIL]",
        "LINEAR_API_KEY": "abc123"
      }
    }
  }
}

MCP DevTools enables your AI assistants to securely connect to external services through the Model Context Protocol. It provides ready-to-use MCP servers for Jira and Linear, letting you perform common workflows by issuing natural language commands that are translated into tool actions. This guide shows you how to configure, install, and use these MCP servers in your client workflow.

How to use

Configure each MCP server in your chosen client (Cursor IDE in this example) to enable Jira and Linear integrations. Once configured, you can interact with the tools using natural language commands to fetch, search, read, create, and manage issues and tickets.

How to install

Prerequisites you need before installation:

Node.js 12+ or newer (recommended)
npm or pnpm for package management

Follow these steps to prepare and run the MCP servers locally:

# Install pnpm if you don't have it
npm install -g pnpm

# Install all dependencies in the workspace
pnpm install

# Build all packages
pnpm build

# Development with auto-rebuild
pnpm dev

Configuration and usage highlights

Two MCP servers are exposed for Jira and Linear integrations. Each server runs as a stdio process and is started with an environment-driven command. The Jira server requires Jira credentials and workspace URL; the Linear server requires a Linear API key.

Use the following configurations in your MCP client to start the servers. Do not modify the structure below; copy exactly as shown for your client setup.

{
  "mcpServers": {
    "jira_mcp": {
      "type": "stdio",
      "command": "env",
      "args": [
        "JIRA_URL=https://[YOUR_WORKSPACE].atlassian.net",
        "JIRA_API_MAIL=[YOUR_EMAIL]",
        "JIRA_API_KEY=[YOUR_API_KEY]",
        "npx",
        "-y",
        "@mcp-devtools/jira"
      ],
      "env": [
        {"name": "JIRA_URL", "value": "https://[YOUR_WORKSPACE].atlassian.net"},
        {"name": "JIRA_API_MAIL", "value": "[YOUR_EMAIL]"},
        {"name": "JIRA_API_KEY", "value": "[YOUR_API_KEY]"}
      ]
    },
    "linear_mcp": {
      "type": "stdio",
      "command": "env",
      "args": [
        "LINEAR_API_KEY=[YOUR_API_KEY]",
        "npx",
        "-y",
        "@mcp-devtools/linear"
      ],
      "env": [
        {"name": "LINEAR_API_KEY", "value": "[YOUR_API_KEY]"}
      ]
    }
  }
}

Available tools

get_ticket

Fetch a specific Jira ticket by key to retrieve its details.

execute_jql

Run a Jira JQL query to search for tickets matching specific criteria.

read_ticket

Read and display details for a Jira ticket.

create_ticket

Create a new Jira ticket with provided project, summary, description, and issue type.

get_issue

Fetch a specific Linear issue by key to retrieve its details.

search_issues

Search Linear issues with a query, optionally limiting results.

create_issue

Create a new Linear issue with team, title, description, and priority.

list_teams

List teams available in Linear for assignment and filtering.