home / mcp / mcp jira server

MCP Jira Server

MCP for JIRA Bot

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "imrnbeg-jira-mcp": {
      "command": "node",
      "args": [
        "/full/path/to/your/jira-mcp/dist/server.js"
      ],
      "env": {
        "JIRA_URL": "https://yourcompany.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

This MCP Jira Server lets you query and view Jira data directly through Claude Desktop by exposing Jira through a Model Context Protocol server. You can look up issues, browse projects, inspect workflows, run JQL searches, and view agile boards, all from your Claude chats, with secure access to your Jira instance.

How to use

You can interact with Jira data from Claude Desktop by invoking the MCP endpoints through natural language prompts. Use concise, task-based prompts to fetch information such as issue details, project metadata, or board and sprint data. Examples include asking for a specific Jira issue, listing projects you have access to, or viewing the active sprint issues on a board.

Practical usage patterns you can try in Claude Desktop include:

What you can do with the server

- Get Jira Issue Details: fetch comprehensive information about an issue by key (summary, description, status, priority, assignee, etc.).

- Browse Projects: list projects and view project details.

- Understand Workflows: view issue types and statuses per project.

- Search Issues (JQL): perform flexible searches with pagination and selected fields.

- Project Issue Lists: quickly list issues within a project.

- Issue Comments: read comments on an issue.

- Agile Views: access boards, sprints, and sprint issue listings.

- Secure Authentication: uses Jira API tokens for secure access.

- Structured Data: returns both human-readable and structured JSON data for programmatic use.

How to install

Prerequisites you need before installation:

Node.js v18 or higher
Claude Desktop application
A Jira instance with API access
A Jira API token

Step-by-step setup commands

# 1. Clone the project
git clone https://github.com/imrnbeg/jira-mcp.git
cd jira-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

Configure environment variables and paths as shown below. You will set Jira credentials and the Jira URL, then adjust the server path in code and rebuild when needed.

Configuration

1) Create Environment File and populate Jira credentials:

# .env
JIRA_URL=https://yourcompany.atlassian.net
[email protected]
JIRA_API_TOKEN=your_api_token_here

2) Update Server Path (Important)

Edit the server path so the MCP loads your environment file from your system.

// Change this path to match your system
loadEnvFile('/Users/imranbeg/mcp-get-server/.env');
```

Paths for different systems:
- macOS/Linux: /full/path/to/your/jira-mcp/.env
- Windows: C:\\full\\path\\to\\your\\jira-mcp\\.env

3) Rebuild After Path Update

npm run build

Available tools

get_jira_issue

Fetches detailed information about a Jira issue by its key, including summary, description, status, assignee, reporter, priority, issue type, creation and update dates, and a direct Jira link.

list_jira_projects

Lists accessible Jira projects with optional search and pagination.

get_jira_project

Retrieves full metadata for a Jira project by key or ID.

get_project_statuses

Gets available statuses for each issue type within a project.

search_jira_issues

Searches Jira issues using JQL with pagination and selectable fields.

list_project_issues

Lists issues within a specific project with optional extra JQL filters.

get_jira_issue_comments

Retrieves comments for a specific Jira issue.

list_boards

Lists Jira boards with optional filters for type and project.

list_board_sprints

Lists sprints on a specified board and optional state filter.

list_sprint_issues

Lists issues within a sprint with pagination and optional JQL filters.