@supernova123/jira-mcp-server

Jira MCP Server

A Model Context Protocol server for Jira integration. Provides 14 tools for searching, creating, updating, and transitioning issues, plus managing projects, boards, sprints, and links.

Features

• Search Issues — Query with full JQL support
• Issue CRUD — Create, read, update, delete issues
• Transitions — Move issues through workflows
• Comments — Add comments to issues
• Projects — List and inspect projects
• Issue Types — Query available issue types
• Links — Link issues with typed relationships
• Boards — List Jira Software boards
• Sprints — Query sprint states and goals
• Backlog — View board backlog items

Installation

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[e-mail]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cursor / VS Code

Add to your MCP configuration:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["-y", "jira-mcp-server"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "[e-mail]",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Manual

npm install -g jira-mcp-server
export JIRA_HOST=your-domain.atlassian.net
export JIRA_EMAIL=[e-mail]
export JIRA_API_TOKEN=your-api-token
jira-mcp-server

Environment Variables

Variable	Required	Description
JIRA_HOST	Yes	Your Jira hostname (e.g. your-domain.atlassian.net)
JIRA_API_TOKEN	Yes	Jira API token or Personal Access Token
JIRA_EMAIL	Cond.	Your Jira email (required for Basic auth)
JIRA_AUTH_TYPE	No	basic (default) or bearer (for PAT)
JIRA_API_VERSION	No	REST API version (default: 3)

Tools

Tool	Description
jira_search	Search issues with JQL
jira_get_issue	Get full issue details
jira_create_issue	Create a new issue
jira_update_issue	Update issue fields
jira_transition_issue	Transition issue to new status
jira_add_comment	Add a comment to an issue
jira_delete_issue	Delete an issue (permanent)
jira_list_projects	List accessible projects
jira_get_project	Get project details
jira_get_issue_types	List issue types for a project
jira_link_issues	Create a link between two issues
jira_get_boards	List Jira Software boards
jira_get_sprints	List sprints for a board
jira_get_backlog	Get board backlog items

Usage

Search issues with JQL

{ "tool": "jira_search", "arguments": { "jql": "project = PROJ AND status = Open ORDER BY created DESC" } }

Create a bug

{
  "tool": "jira_create_issue",
  "arguments": {
    "projectKey": "PROJ",
    "summary": "Login page broken on mobile",
    "issueType": "Bug",
    "priority": "High",
    "labels": "mobile,urgent"
  }
}

Transition an issue

{ "tool": "jira_transition_issue", "arguments": { "issueKey": "PROJ-123", "transitionName": "In Progress" } }

API Coverage

Resource	Tools
Issues	jira_search, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_delete_issue
Comments	jira_add_comment
Projects	jira_list_projects, jira_get_project
Issue Types	jira_get_issue_types
Links	jira_link_issues
Boards	jira_get_boards
Sprints	jira_get_sprints
Backlog	jira_get_backlog

Development

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

License

MIT