MCP Server Atlassian Jira

Name: MCP Server Atlassian Jira
Author: Andi Ashari

Generic GET, POST, PUT, PATCH and DELETE access to the Jira Cloud REST API for MCP clients

By Andi Ashari (individual) TypeScript Local · stdio Productivity Developer tools

GitHub npm Website

59 popularity score ★ 78 ↓ 22k/wk

Connect your client

Local (npm)

Add in one click

Add to Cursor Add to VS Code Add to LM Studio Add to Goose

Opens the app, which asks before it adds the server. Then replace each <NAME> in its settings with your value.

Or add it by command or config

It needs ATLASSIAN_SITE_NAME, ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN. Replace each <NAME> with your value.

Claude CodeTerminal

claude mcp add atlassian-jira -e ATLASSIAN_SITE_NAME=<ATLASSIAN_SITE_NAME> -e ATLASSIAN_USER_EMAIL=<ATLASSIAN_USER_EMAIL> -e ATLASSIAN_API_TOKEN=<ATLASSIAN_API_TOKEN> -- npx -y @aashari/mcp-server-atlassian-jira

Claude Desktopclaude_desktop_config.json

{
  "mcpServers": {
    "atlassian-jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
        "ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
        "ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
      }
    }
  }
}

Cursor~/.cursor/mcp.json

{
  "mcpServers": {
    "atlassian-jira": {
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
        "ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
        "ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
      }
    }
  }
}

VS Code.vscode/mcp.json

{
  "servers": {
    "atlassian-jira": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@aashari/mcp-server-atlassian-jira"
      ],
      "env": {
        "ATLASSIAN_SITE_NAME": "<ATLASSIAN_SITE_NAME>",
        "ATLASSIAN_USER_EMAIL": "<ATLASSIAN_USER_EMAIL>",
        "ATLASSIAN_API_TOKEN": "<ATLASSIAN_API_TOKEN>"
      }
    }
  }
}

Codex~/.codex/config.toml

[mcp_servers.atlassian-jira]
command = "npx"
args = ["-y", "@aashari/mcp-server-atlassian-jira"]

[mcp_servers.atlassian-jira.env]
ATLASSIAN_SITE_NAME = "<ATLASSIAN_SITE_NAME>"
ATLASSIAN_USER_EMAIL = "<ATLASSIAN_USER_EMAIL>"
ATLASSIAN_API_TOKEN = "<ATLASSIAN_API_TOKEN>"

Gemini CLITerminal

gemini mcp add --scope user -e ATLASSIAN_SITE_NAME=<ATLASSIAN_SITE_NAME> -e ATLASSIAN_USER_EMAIL=<ATLASSIAN_USER_EMAIL> -e ATLASSIAN_API_TOKEN=<ATLASSIAN_API_TOKEN> atlassian-jira npx -- -y @aashari/mcp-server-atlassian-jira

Settings 6

`ATLASSIAN_SITE_NAME`	Required: Your Jira Cloud site name, the part before .atlassian.net.
`ATLASSIAN_USER_EMAIL`	Required: Email address of the Atlassian account the token belongs to.
`ATLASSIAN_API_TOKEN`	Required: Atlassian API token for that account.
`TRANSPORT_MODE`	Optional: stdio (default) or http to serve Streamable HTTP at /mcp.
`PORT`	Optional: Port for http mode; 3000 by default.
`DEBUG`	Optional: Set to true to write debug logs under ~/.mcp/data/.

What it does

This is a community-built MCP server for Jira Cloud, published on npm by aashari. Since version 3.0 it no longer has one tool per task (list projects, get issue, add comment). Instead it has five tools, one for each HTTP method. Each takes a Jira REST path, plus optional query parameters and a JSON body, so the assistant can call any Jira Cloud REST v3 endpoint your account can reach: JQL issue search, creating and editing issues, transitions, comments, worklogs, users and statuses.

Responses come back in TOON by default, a compact tabular format meant to use fewer tokens than JSON. Set outputFormat to json to get JSON. Every tool also takes a JMESPath expression (jq) that trims the response to the fields you need. A response over about 40,000 characters is cut short, and the full raw response is written to a file under /tmp/mcp/mcp-server-atlassian-jira/.

The same package also works as a command-line tool: given arguments (get, post and so on) it runs one request and exits, and without arguments it starts as an MCP server. It speaks stdio by default. The README leaves out its other mode: in v3.3.0's src/index.ts, setting TRANSPORT_MODE=http starts a Streamable HTTP server at /mcp on PORT (3000 by default), with CORS open and no authentication of its own.

What it needs

Runtime	Node.js 18+

Node.js 18 or newer (the command uses npx). A Jira Cloud site (<name>.atlassian.net), an Atlassian account with access to the projects you want, and an Atlassian API token for that account, created at id.atlassian.com. Jira Server and Data Center are not supported.

Limits

Jira Cloud only, because the base URL is always https://<ATLASSIAN_SITE_NAME>.atlassian.net, so self-hosted Server and Data Center sites cannot be reached. It signs in only with an email address and API token; there is no OAuth. The tools have no built-in helpers: the assistant must know the right REST path and body format, for example Atlassian Document Format for comment and description text. Responses over about 40,000 characters are truncated, with the full text saved to a file in /tmp. The v2.x task-specific tools (jira_ls_projects, jira_get_issue and others) were removed in 3.0, so older configurations and prompts that name them no longer work.

Who it suits

Suits Jira Cloud users who want an assistant to reach the whole REST API, including writes, and who are fine with the assistant writing raw REST calls. It runs on your own machine with a personal API token. Pick something else if you use Jira Server or Data Center, need OAuth or admin-managed access instead of a personal token, or want narrow, task-specific tools that limit what the assistant can do. The same author also publishes Confluence and Bitbucket servers that work the same way (mcp-server-atlassian-confluence, mcp-server-atlassian-bitbucket).

Tools 5

jira_get: Sends a GET request to any Jira REST path to read data, with optional query parameters and JMESPath filter
jira_post: Sends a POST request with a JSON body, e.g. to create issues or add comments and worklogs
jira_put: Sends a PUT request with a JSON body to update a resource such as an issue
jira_patch: Sends a PATCH request with a JSON body to change only some fields
jira_delete: Sends a DELETE request to remove a resource such as a comment, worklog or issue

Popularity

59 popularity score, on our list (the bar is 36)

★ 78 ↓ 22k/wk

GitHub stars	78	22.8 points
Stars in 30 days	+1	1.5 points
npm downloads, last week	21,788	34.7 points

Measured 2026-11-07. How the score works.

Where it is published

Code	aashari/mcp-server-atlassian-jira ★ 78
npm	@aashari/mcp-server-atlassian-jira 3.3.0, 2025-12-03

What it can reach

Runs	On your machine
Reaches	Your account at a service, The internet
Changes things	Yes: it can write, send, create or delete
Sign-in	An API key or token
Licence	ISC (npm)
Last code change	2026-03-06

The server runs on your machine and calls https://<site>.atlassian.net using HTTP basic auth with your Atlassian email and API token. It can do whatever that account can do in Jira, because the tools accept any path on the site and every HTTP method, including DELETE. Nothing restricts it to reading, and the tools carry no read-only or destructive hints. Credentials can come from environment variables or from ~/.mcp/configs.json. Large responses are written in full to /tmp/mcp/mcp-server-atlassian-jira/, and debug logs, when DEBUG is set, go to ~/.mcp/data/. In http mode it listens on PORT (3000 by default) with CORS open to any origin and no authentication of its own (src/index.ts, v3.3.0).

Over time

GitHub stars 78 +1 (+1 %)

7877

8 Oct 20267 Nov 2026

npm downloads a week 22k +20k (+1400 %)

22k835

20 Oct 20257 Nov 2026

Before the site measured it, read from npm's daily download counts.

Popularity score 59 +2 (+4 %)

5954

8 Oct 20267 Nov 2026

What is rising across the directory

Sources

Page checked 2026-10-14.

Badge for your README

Shows this server's rank in its category, and stars for a server that runs on your machine. It updates every hour.

MarkdownREADME.md

[![MCP Server Atlassian Jira on EveryMCPServer](https://everymcpserver.com/badge/mcp-server-atlassian-jira.svg)](https://everymcpserver.com/servers/mcp-server-atlassian-jira)

Connect your client

Add in one click

Or add it by command or config

Settings 6

What it does

What it needs

Limits

Who it suits

Tools 5

Similar servers

MCP Server Atlassian Confluence

Atlassian Jira Data Center MCP

MCP Server Atlassian Bitbucket

Swagger Remote MCP Server

CodeQL Development MCP Server

Hygraph MCP Server