@tarasrushchak/jira-mcp-server

MCP (Model Context Protocol) server for Jira and Confluence integration. Provides 32 tools for managing Jira tickets, sprints, boards, worklogs, and Confluence pages through any MCP-compatible client.

Supports both Jira Cloud and Jira Server/Data Center.

Installation

Via npm (recommended)

npx @tarasrushchak/jira-mcp-server

Via npm global install

npm install -g @tarasrushchak/jira-mcp-server
jira-mcp-server

From source

git clone https://github.com/TarasKhust/jira-mcp-server.git
cd jira-mcp-server
npm install
npm run build
npm start

Configuration

Create a .env file or pass environment variables directly:

Required (Jira)

JIRA_HOST=https://your-domain.atlassian.net
[email protected]
JIRA_API_TOKEN=your-api-token

Optional (Confluence/KB)

CONFLUENCE_HOST=https://your-confluence.atlassian.net
[email protected]
CONFLUENCE_API_TOKEN=your-api-token

MCP Client Configuration

Add to your MCP client config:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "@tarasrushchak/jira-mcp-server"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

Ticket Management

| Tool | Description | |------|-------------| | list_tickets | List tickets assigned to you (with optional JQL filter) | | get_ticket | Get details of a specific ticket including linked issues | | create_ticket | Create a new ticket with custom fields support | | search_tickets | Full-text search across multiple projects | | delete_issue | Delete a ticket |

Comments

| Tool | Description | |------|-------------| | add_comment | Add a comment with @mention support | | get_comments | Get all comments for a ticket | | delete_comment | Delete a specific comment | | delete_all_comments | Delete all comments from a ticket |

Status & Workflow

| Tool | Description | |------|-------------| | update_status | Change ticket status via transitions | | get_transitions | Get available status transitions | | assign_ticket | Assign/unassign a ticket |

Field Updates

| Tool | Description | |------|-------------| | update_ticket_fields | Update fields (story points, labels, priority, due date, custom fields, etc.) | | get_ticket_fields | Get field metadata and current values | | get_available_fields | Get available fields with IDs for a project/issue type |

Time Tracking

| Tool | Description | |------|-------------| | add_worklog | Log time spent on a ticket | | get_worklog | Get worklog entries | | update_worklog | Update an existing worklog | | delete_worklog | Delete a worklog entry |

Issue Links

| Tool | Description | |------|-------------| | create_issue_link | Link two issues together | | remove_issue_link | Remove an issue link |

Projects & Versions

| Tool | Description | |------|-------------| | get_all_projects | List all projects | | get_project_issues | Get issues for a project | | get_project_versions | Get project versions | | create_version | Create a new version | | batch_create_issues | Create multiple issues at once |

Agile / Sprints

| Tool | Description | |------|-------------| | get_agile_boards | List agile boards | | get_board_issues | Get issues from a board | | get_sprints_from_board | Get sprints from a board | | get_sprint_issues | Get issues in a sprint |

Users

| Tool | Description | |------|-------------| | search_users | Search users by email or name | | get_user_profile | Get user profile info |

Confluence / Knowledge Base

| Tool | Description | |------|-------------| | get_kb_page | Get a page by ID or URL | | search_kb_pages | Search pages (text or CQL) | | get_kb_page_children | Get child pages | | get_kb_page_comments | Get page comments | | get_kb_spaces | List available spaces |

Getting a Jira API Token

1. Go to Atlassian API tokens
2. Click "Create API token"
3. Give it a label and copy the token

For Jira Server/Data Center, use your password or a personal access token.

License

GPL-2.0 - See LICENSE.txt for details.