Jira Mcp Server

io.github.friendlygeorgePublished by GitHub account friendlygeorgev1.0.0Updated Oct 24, 2026

MCP server for Jira — search, create, update, transition issues, manage projects, boards, and spr...

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

A local MCP server that connects an AI assistant to Jira Cloud so it can search, create, update and transition issues, and inspect projects, boards and sprints.

What you can do
Search and read issues with JQL, including full issue details and issue types per project, and list accessible projects with their details. Create, update, transition and permanently delete issues, and add comments. Link related issues to each other. List Jira Software boards, their sprints, and board backlog items.
When to use it
Useful when you manage work in Jira Cloud and want to triage, create or move tickets, plan sprints, or get cross-project overviews from a chat client instead of the Jira UI.
Requirements
Runs locally via npx or a global npm install (Node.js). Needs a Jira Cloud host set in JIRA_HOST, an API token or personal access token in JIRA_API_TOKEN, and JIRA_EMAIL for basic auth; JIRA_AUTH_TYPE and JIRA_API_VERSION are optional. Network access to the Atlassian instance is required.
Before you install
The token in JIRA_API_TOKEN grants access to your Jira data and should be scoped and kept secret. The server can write to Jira: create, update, transition, comment, link, and permanently delete issues, so assistant actions can change or destroy real tickets. Issue content is sent to the configured Jira host.

Installation

In SourceWeft

  1. Open Jira Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Jira MCP Server

An MCP server for Jira — connect any MCP-compatible client to your Jira projects, issues, sprints, and boards.

[MCP Compatible] [TypeScript] [License: MIT]

What is this?

An MCP (Model Context Protocol) server that gives AI assistants and agents full access to your Jira instance — search issues with JQL, create and update tickets, manage sprints and boards, transition issues through workflows, and link related work — all through natural language.

Use it with Claude Desktop, Cursor, Windsurf, Cline, Continue, or any MCP-compatible client to manage your projects without leaving the chat.

Why use this?

  • 14 built-in tools — covers search, CRUD, transitions, comments, projects, boards, sprints, and backlog
  • Full JQL support — search issues with any Jira Query Language expression
  • Workflow transitions — move issues through your custom workflows by name
  • Sprint management — query sprint states, goals, and board backlogs
  • Works with Jira Cloud — connects to any *.atlassian.net instance

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor / VS Code

Add to your MCP configuration:

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

Manual

bash
npm install -g jira-mcp-serverexport JIRA_HOST=your-domain.atlassian.netexport [email protected]export JIRA_API_TOKEN=your-api-tokenjira-mcp-server

Environment Variables

VariableRequiredDescription
JIRA_HOSTYesYour Jira hostname (e.g. your-domain.atlassian.net)
JIRA_API_TOKENYesJira API token or Personal Access Token
JIRA_EMAILCond.Your Jira email (required for Basic auth)
JIRA_AUTH_TYPENobasic (default) or bearer (for PAT)
JIRA_API_VERSIONNoREST API version (default: 3)

Getting your API token

  1. Go to Atlassian API Tokens
  2. Click Create API token
  3. Give it a name (e.g. "MCP Server") and copy the token
  4. Use your Atlassian email as JIRA_EMAIL

Tools

ToolDescription
jira_searchSearch issues with JQL
jira_get_issueGet full issue details
jira_create_issueCreate a new issue
jira_update_issueUpdate issue fields
jira_transition_issueTransition issue to new status
jira_add_commentAdd a comment to an issue
jira_delete_issueDelete an issue (permanent)
jira_list_projectsList accessible projects
jira_get_projectGet project details
jira_get_issue_typesList issue types for a project
jira_link_issuesCreate a link between two issues
jira_get_boardsList Jira Software boards
jira_get_sprintsList sprints for a board
jira_get_backlogGet board backlog items

Usage Examples

Search issues with JQL

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

Create a bug

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

Transition an issue

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

Get sprint backlog

json
{ "tool": "jira_get_backlog", "arguments": { "boardId": "42" } }

Use Cases

  • Project management — "Show me all open bugs in the mobile project" → jira_search with JQL
  • Sprint planning — "What's in the current sprint?" → jira_get_sprints + jira_get_backlog
  • Issue triage — "Create a bug for the login timeout" → jira_create_issue
  • Workflow automation — "Move PROJ-456 to In Review" → jira_transition_issue
  • Cross-project overview — "List all projects I have access to" → jira_list_projects

API Coverage

ResourceTools
Issuesjira_search, jira_get_issue, jira_create_issue, jira_update_issue, jira_transition_issue, jira_delete_issue
Commentsjira_add_comment
Projectsjira_list_projects, jira_get_project
Issue Typesjira_get_issue_types
Linksjira_link_issues
Boardsjira_get_boards
Sprintsjira_get_sprints
Backlogjira_get_backlog

Development

bash
git clone https://github.com/friendlygeorge/jira-mcp-server.gitcd jira-mcp-servernpm installnpm run buildnpm start

License

MIT

Source: README.md at commit 4178fd7

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts