PlugWiki
mcp-server-atlassian-jira logo

Jira MCP Server by aashari: Setup for Claude, Cursor and Other Apps

CommunityLocal
Getnpm@aashari/mcp-server-atlassian-jiraaashari/mcp-server-atlassian-jira
Tools
5
1 read · 4 change
Stars
78
on GitHub
Downloads
18.6K
a week
Works in
12
apps
Risk
High
can delete

Lets your AI assistant search, create, edit and delete issues and other items in Jira Cloud.

This community server lets Claude, Cursor and other assistants work with Jira Cloud. It has five generic tools, one for each web request type, so the assistant can reach almost anything in the Jira API. It runs on your computer with your Atlassian email, site name and an API token, and it works only with Jira Cloud. There is no read-only mode, and one tool can delete things.

Good for

  • Jira Cloud users who want Claude or Cursor to find and update issues
  • Developers who prefer one flexible server over a long list of fixed tools
  • Teams that accept an API token on a laptop instead of company sign-in

Works in

12 should work

Tap an app to see how to set it up and any known problems.

Install mcp-server-atlassian-jira

Claude Code

  1. 1

    Copy this prompt.

    Add the mcp-server-atlassian-jira server to Claude Code. Run this command:

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

Ask me for ATLASSIAN_SITE_NAME, ATLASSIAN_USER_EMAIL, ATLASSIAN_API_TOKEN and only put the values in that config, nowhere else.

Then check that it loaded and tell me if I need to sign in or restart.
  2. 2

    Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

Built from the package data we hold. Not yet tested by us.

Tools

  • Reads any Jira data: projects, issues, comments, users

    Calls any Jira Cloud read endpoint you name, such as an issue, a JQL search or a project list. The assistant can trim the reply with a filter so it uses fewer tokens.

    Try: “Show my open issues in project PROJ that were created in the last 7 days.”

    Network · jira_get

  • Creates Jira items such as issues and comments

    Sends a create request to any Jira Cloud endpoint. Typical uses are a new issue, a comment, a worklog entry or moving an issue to another status.

    Try: “Create a task in PROJ titled "Fix login redirect" and assign it to me.”

    Write · jira_post

  • Replaces a Jira item with new content

    Sends a full replace to a Jira endpoint, so anything you leave out of the request can be overwritten. The README suggests the patch tool for partial changes.

    Try: “Replace the properties on PROJ-123 with this new set.”

    Write · jira_put

  • Changes only the fields you name on a Jira item

    Updates selected fields on an issue, comment or worklog and leaves the rest as it was. It is the safer way to edit.

    Try: “Change the title of PROJ-123 to "Fix login redirect on Safari".”

    Write · jira_patch

  • Deletes Jira items such as issues, comments and attachments

    Sends a delete to any Jira endpoint you name. Its own notes list deleting an issue (with its subtasks if asked), a comment, a worklog, an attachment or a watcher.

    Try: “Delete the duplicate issue PROJ-456.”

    Delete · jira_delete

Read from the source code

Permissions

high risk · 4 things to watch

High risk

The assistant can read, change and delete anything your Jira account can, and there is no read-only switch. Use a token from an account with limited rights and ask for a confirmation before any delete.

What it can do

  • Read your data
  • Create and change things
  • Delete things
  • Read-only mode

Watch out for

  • One tool can delete issues and attachments

    jira_delete sends a delete to any endpoint, and its notes list issues, comments, worklogs and attachments. Ask the assistant to confirm each delete, or use a token on an account with limited Jira permissions. github.com

  • No read-only mode

    All five tools are always available, including create and replace. If you only want searching, use a token tied to an account that can only browse. github.com

  • Acts with your full Jira rights

    The API token has the same access as your account. Anything your account can change in Jira, the assistant can change. github.com

  • Large replies are saved to a temp folder

    Replies over about 40,000 characters are cut short, and the full text is saved under /tmp/mcp/mcp-server-atlassian-jira/. That file can hold issue content. github.com

Security advisories

No published security advisories as of Nov 1, 2026.

Technical details
Turning on read-onlyNo read-only mode is documented. The delete tool is always on.
Talks toYour Jira Cloud site (yoursite.atlassian.net)
Sign-in and keysAn Atlassian API token, your account email and site name, set as environment variables in the app config. A config file in ~/.mcp/configs.json is also supported.

Questions

Is this the official Atlassian Jira MCP server?

No. It is a community project by aashari. Atlassian publishes its own server, which runs on Atlassian's side at https://mcp.atlassian.com/v2/mcp; see the Atlassian MCP page.

How is it different from the official Atlassian server?

This one runs on your machine with an API token and gives you five generic request tools for Jira Cloud only. The official server is hosted by Atlassian, signs in with OAuth and also covers Confluence and other Atlassian products. The other community option, mcp-atlassian (see its page), covers Jira and Confluence with many named tools and also supports Jira Server and Data Center.

What do I need to sign in?

Your Jira site name, your Atlassian account email and an API token, all set in the install box. You create the token in your Atlassian account security settings.

Can it delete my Jira issues?

Yes. The delete tool can remove issues, comments, worklogs, attachments and watchers, and there is no read-only mode to turn it off.

Does it work with Jira Server or Data Center?

No. The README says it supports Jira Cloud only.

Does it need Node.js?

Yes. The install box starts it with npx, which comes with Node.js.

Which apps does it work with?

Any app that can start a local MCP server over stdio, such as Claude Desktop, Claude Code and Cursor. The README says most assistants that support MCP work.

Information

updated Nov 2, 2026

Publisher
Community
Package
@aashari/mcp-server-atlassian-jira
Registry
npm
Transport
stdio
Auth
token in env
Version
3.3.0
License
ISC
Last commit
Mar 6, 2026
Open issues
8

GitHubnpmChangelogIssues

Other Jira MCP servers

See all

Sources

Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.

Show all 2
  1. github.com · github.com
  2. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.