home / mcp / jira mcp server

Jira MCP Server

MCP server enabling Jira task queries, details, and creation via an MCP client.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ilidaniys-jira-mcp-server": {
      "command": "node",
      "args": [
        "/absolute/path/to/jira-mcp-server/index.js"
      ],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_BASE_URL": "https://cryptobplatform.atlassian.net",
        "JIRA_API_TOKEN": "your-api-token-here",
        "JIRA_ASSIGNEE_ACCOUNT_ID": "6148ce85071141006ab17eb7"
      }
    }
  }
}

You can run a Jira MCP Server to let Claude Code and other MCP clients interact with Jira tasks. It handles fetching your tasks, viewing task details, and creating new Jira issues through a simple MCP interface.

How to use

You will run a local MCP server and connect your MCP client to it. The server exposes endpoints that let you list tasks assigned to you, filter by project or status, retrieve detailed information for a specific task, and create new tasks with a description and chosen issue type. Use these capabilities to streamline Jira task management from your MCP-enabled workflows.

How to install

Prerequisites you need before starting:

Node.js 18+ installed on your machine
A Jira account with API access
A Jira API token

How to install

# 1. Clone the MCP server repository
# Replace with your actual repo URL
git clone <your-repo-url>
cd jira-mcp-server

# 2. Install dependencies
npm install

How to install

Next, obtain a Jira API token and your account settings, then configure environment variables for the MCP to use.

How to install

# 1) Generate a Jira API token from your Jira account settings
# 2) Create a local environment config file (example shown is .env)
cp .env.example .env
# Edit .env with your credentials

How to install

Configure your Claude Code or MCP client to point to the Jira MCP Server by specifying the runtime command, the server script, and the necessary environment variables.

How to install

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/absolute/path/to/jira-mcp-server/index.js"],
      "env": {
        "JIRA_BASE_URL": "https://cryptobplatform.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token-here",
        "JIRA_ASSIGNEE_ACCOUNT_ID": "6148ce85071141006ab17eb7"
      }
    }
  }
}

Security and notes

Never expose your Jira API token. Keep tokens secure and avoid committing them to version control. When configuring in your MCP client, prefer environment variables over hard-coded values and ensure access is restricted to trusted users.

Troubleshooting

Authentication issues usually mean the API token or email does not match your Jira account. If a task cannot be found, verify the task key format (for example ART-114) and ensure you have the necessary permissions to view it. If environment variables fail to load in your MCP client, confirm you placed them in the client’s MCP config section.

Project structure

jira-mcp-server/ contains the main MCP server implementation and supporting files. You will typically run the server from index.js via Node after installing dependencies.

License

MIT

Author

andreu slynchyk ([email protected])

Available tools

get_my_tasks

Fetch Jira tasks assigned to you with optional project and status filters.

get_task_details

Retrieve detailed information about a specific Jira task by key.

create_task

Create a new Jira task with project, summary, optional description, and issue type.