MCP Atlassian (Jira and Confluence)

At a glance

mcp-atlassian is the most used community server for Atlassian tools. It searches and updates Jira issues with JQL, manages sprints and transitions, and reads and writes Confluence pages, for both Cloud and Server/Data Center.

You can set it to read-only, and you can limit which Confluence spaces and Jira projects it sees.

Made by

sooperset and community contributors (not Atlassian)

Latest version

0.23.1 (19 Aug 2026)

PyPI package

mcp-atlassian

GitHub stars

6K

Downloads

215.9K a week

Last commit

19 Sept 2026

Tools

98

Runs on

Your computer

Our check: We ran this exact config on 26 Oct 2026: it started and answered with 98 tools. The npm package called "mcp-atlassian" comes from a different repository (Vijay-Duke/mcp-atlassian). This project is a Python package of the same name, so it runs with uvx.

What's in the pod: its tools

We found 98 tools when we started it on 26 Oct 2026. 58 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.

Grouped and described by us. The README on GitHub lists the inputs each tool takes.

Set it up

Pick your app for the exact snippet and where it goes.

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@company.com",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    }
  }
}

claude mcp add-json atlassian '{"command":"uvx","args":["mcp-atlassian"],"env":{"JIRA_URL":"https://your-company.atlassian.net","JIRA_USERNAME":"you@company.com","JIRA_API_TOKEN":"your-token","CONFLUENCE_URL":"https://your-company.atlassian.net/wiki","CONFLUENCE_USERNAME":"you@company.com","CONFLUENCE_API_TOKEN":"your-token"}}'

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@company.com",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    }
  }
}

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@company.com",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    }
  }
}

{
  "mcpServers": {
    "atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian"
      ],
      "env": {
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "you@company.com",
        "JIRA_API_TOKEN": "your-token",
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "you@company.com",
        "CONFLUENCE_API_TOKEN": "your-token"
      }
    }
  }
}

Add "READ_ONLY_MODE": "true" to env while you try it out.

New to this? See the setup guides for Claude Code, Cursor, Claude Desktop and ChatGPT.

Settings

Names are exactly as the project spells them. Required ones are marked.

What it can touch

Safer setup: Set READ_ONLY_MODE=true until you trust it, and narrow it with ENABLED_TOOLS and the project and space filters.

Before you start

• uv (for uvx)
• An Atlassian API token (Cloud) or personal access token (Server/Data Center)

If it does not work

401 Unauthorized on Atlassian Cloud

Use your account email as the username and an API token, not your password. Check the URL has no trailing path for Jira and ends in /wiki for Confluence.

401 on Jira Server or Data Center

Use JIRA_PERSONAL_TOKEN (and CONFLUENCE_PERSONAL_TOKEN) instead of username and API token.

SSL certificate errors on a self-hosted instance

Set JIRA_SSL_VERIFY=false and CONFLUENCE_SSL_VERIFY=false only if you trust the network, or add your company's certificate authority to the machine.

The assistant ignores the right tool among almost 100

Set ENABLED_TOOLS to the dozen you actually use.

Peas in a pod: similar servers

How MCP Atlassian (Jira and Confluence) lines up against other knowledge and work apps servers on the shelf.

Questions

Something wrong on this page? Tell us.