PlugWiki

mcp-atlassian MCP Server: Jira and Confluence for Claude and Cursor

CommunityLocal
GetPyPImcp-atlassiansooperset/mcp-atlassian

Not the official Atlassian MCP server. This one is built by the community. Atlassian makes its own: Atlassian Rovo MCP Server →

Lets Claude and Cursor search, read and edit your Jira issues and Confluence pages, on Atlassian Cloud or your own Server.

This is a community server, not made by Atlassian. It lets Claude, Cursor and other assistants search, read, create and edit Jira issues and Confluence pages, on Atlassian Cloud or Server/Data Center. It runs on your computer and signs in with an Atlassian API token (Cloud) or a personal access token (Server/Data Center). Those tokens carry your own permissions, so the assistant can delete anything you can unless you turn on read-only mode.

Good for

  • Teams that want Claude to find, triage and update Jira issues
  • Anyone who wants Confluence searched, summarised or edited from chat
  • Self-hosted Jira and Confluence users on Server or Data Center
  • Scrum leads who manage sprints, boards and versions

Works in

12 should work

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

Install mcp-atlassian

Claude Code

  1. 1

    Copy this prompt.

    Add the mcp-atlassian server to Claude Code. Run this command:
    
    claude mcp add atlassian -e JIRA_URL=<JIRA_URL> -e JIRA_USERNAME=<JIRA_USERNAME> -e JIRA_API_TOKEN=<JIRA_API_TOKEN> -e CONFLUENCE_URL=<CONFLUENCE_URL> -e CONFLUENCE_USERNAME=<CONFLUENCE_USERNAME> -e CONFLUENCE_API_TOKEN=<CONFLUENCE_API_TOKEN> -- uvx mcp-atlassian
    
    Ask me for JIRA_URL, JIRA_USERNAME, JIRA_API_TOKEN, CONFLUENCE_URL, CONFLUENCE_USERNAME, CONFLUENCE_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 uv (Python).

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

Tools

  • Looks up a Jira user's profile

    Returns a Jira user's name, email and status from an email address, username or account ID.

    Try: “Who is jane.doe@example.com in Jira?”

    Network · jira_get_user_profile

  • Finds people who can be assigned issues

    Searches for users who can be assigned in a project or on one issue, by name or email fragment.

    Try: “Who can I assign issues to in the PLAT project?”

    Network · jira_search_assignable_users

  • Lists who is watching an issue

    Returns the people watching one Jira issue.

    Try: “Who is watching PROJ-123?”

    Network · jira_get_issue_watchers

  • Adds a watcher to an issue

    Adds a user to the watcher list of an issue so they get its updates.

    Try: “Add maria as a watcher on PROJ-123.”

    Write · jira_add_watcher

  • Removes a watcher from an issue

    Takes a user off an issue's watcher list so they stop getting updates.

    Try: “Remove tom from the watchers of PROJ-123.”

    Delete · jira_remove_watcher

  • Reads one issue in full

    Returns an issue's fields, description and optionally comments, links and changelog for one key like PROJ-123.

    Try: “Summarise PROJ-123 and its latest comments.”

    Network · jira_get_issue

  • Searches issues with JQL

    Runs a Jira Query Language search and returns matching issues with the fields you ask for.

    Try: “Find open bugs assigned to me in PROJ, newest first.”

    Network · jira_search

  • Finds field names and IDs

    Searches Jira fields by keyword, including custom fields, to find the right field ID.

    Try: “Which custom field holds story points?”

    Network · jira_search_fields

  • Lists allowed values for a field

    Returns the allowed options of a custom dropdown or select field.

    Try: “What values can the Environment field take?”

    Network · jira_get_field_options

  • Lists a project's issues

    Returns issues from one project, paged.

    Try: “List the latest 20 issues in project PLAT.”

    Network · jira_get_project_issues

  • Shows the next statuses an issue can move to

    Returns the workflow transitions currently available for an issue, with their IDs.

    Try: “What statuses can PROJ-123 move to?”

    Network · jira_get_transitions

  • Reads time logged on an issue

    Returns the worklog entries recorded on an issue.

    Try: “How much time has been logged on PROJ-123?”

    Network · jira_get_worklog

Read from the source code

Permissions

high risk · 5 things to watch

High risk

It can create, edit and delete Jira issues and Confluence pages with your own account's permissions. Turn on read-only mode, or limit it to the tools you need, before you let an assistant loose on a real workspace.

What it can do

Watch out for

  • It can delete issues, pages and attachments

    Tools exist to delete Jira issues and watchers, remove issue links, and delete Confluence pages and attachments. Use read-only mode, or list only the tools you want in ENABLED_TOOLS. github.com

  • It acts with your full Atlassian permissions

    The token is not scoped to a project. Anything your account can change, the assistant can change, so use a dedicated account with limited access if you can. github.com

  • Every tool is on unless you narrow it

    With TOOLSETS unset all tool groups load. Set TOOLSETS=default for the core groups or ENABLED_TOOLS for an exact list. github.com

  • Upload tools read files from the server machine

    Attachment upload takes a file path on the machine running the server. Only approve uploads you expect. github.com

  • HTTP mode listens on all interfaces by default

    If you run it as a network server instead of the normal local setup, the default host is 0.0.0.0. Bind it to 127.0.0.1 or put authentication in front. github.com

Technical details
Turning on read-onlySet READ_ONLY_MODE=true (or pass --read-only). Tools that write are then hidden and refused.
Talks toYour Atlassian site (Jira and Confluence URLs you configure)
Sign-in and keysYou put an Atlassian API token (Cloud) or personal access token (Server/Data Center) in the server config. The README also documents OAuth 2.0.

Questions

Is this the official Atlassian MCP server?

No. It is a separate community project by sooperset, and the README says it is not an official Atlassian product. Atlassian runs its own hosted server, covered on the Atlassian MCP page, which signs in with your Atlassian account.

Does it work with Jira Server and Data Center?

Yes. The README lists Jira Server/Data Center 8.14+ and Confluence Server/Data Center 6.0+ as supported, next to Cloud. Use a personal access token instead of an API token.

What credentials does it need?

On Cloud you need your site URL, your Atlassian email and an API token from your Atlassian account. On Server/Data Center you use a personal access token. The docs also describe OAuth 2.0 setup.

Can I use it read-only?

Yes. Set READ_ONLY_MODE to true and every tool that writes is hidden. You can also set ENABLED_TOOLS to an exact list of tools, or TOOLSETS to a set of groups.

Can I use only Jira or only Confluence?

Yes. Leave out the settings for the product you do not use, and its tools are not listed.

Can it delete things?

Yes. It can delete Jira issues, remove watchers and issue links, and delete Confluence pages and attachments. Read-only mode removes all of these.

Does it run on my computer or in the cloud?

On your computer. The setup in the install box starts it locally, and it talks straight to your Atlassian site. The README also describes Docker and an HTTP mode.

How many tools does it have?

98 in the latest release, v0.23.1 (also the newest on PyPI). The README says 93 and the docs say 96, but the release registers 98 tool functions, and the tools section on this page lists all 98. You can narrow them with TOOLSETS or ENABLED_TOOLS.

Information

updated Nov 2, 2026

Publisher
Community
Package
mcp-atlassian
Registry
PyPI
Transport
stdio, SSE, Streamable HTTP
Auth
token in env
Version
0.23.1
License
MIT

WebsiteGitHubPyPIDocker MCP CatalogChangelogIssues

Other Atlassian MCP servers

Sources

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

Show all 5
  1. README · github.com
  2. Tools reference · github.com
  3. Jira tool registrations · github.com
  4. Confluence tool registrations · github.com
  5. Configuration · github.com

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