MCP Atlassian

Name: MCP Atlassian
Author: sooperset

sooperset

Get started Repository Website & docs

Search and read Confluence spaces and pages, and access Jira issues and project metadata.

Setup

Choose your client, copy the config, then fill in any required environment variables.

Add to Cursor Add to VS Code

claude mcp add atlassian --env CONFLUENCE_URL='<CONFLUENCE_URL>' --env CONFLUENCE_USERNAME='<CONFLUENCE_USERNAME>' --env CONFLUENCE_API_TOKEN='<CONFLUENCE_API_TOKEN>' --env JIRA_URL='<JIRA_URL>' --env JIRA_USERNAME='<JIRA_USERNAME>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' -- docker run -i --rm -e CONFLUENCE_URL -e CONFLUENCE_USERNAME -e CONFLUENCE_API_TOKEN -e JIRA_URL -e JIRA_USERNAME -e JIRA_API_TOKEN ghcr.io/sooperset/mcp-atlassian:latest

~/.codex/config.toml

[mcp_servers.atlassian]
command = "docker"
args = ["run", "-i", "--rm", "-e", "CONFLUENCE_URL", "-e", "CONFLUENCE_USERNAME", "-e", "CONFLUENCE_API_TOKEN", "-e", "JIRA_URL", "-e", "JIRA_USERNAME", "-e", "JIRA_API_TOKEN", "ghcr.io/sooperset/mcp-atlassian:latest"]
env = { CONFLUENCE_URL = "<CONFLUENCE_URL>", CONFLUENCE_USERNAME = "<CONFLUENCE_USERNAME>", CONFLUENCE_API_TOKEN = "<CONFLUENCE_API_TOKEN>", JIRA_URL = "<JIRA_URL>", JIRA_USERNAME = "<JIRA_USERNAME>", JIRA_API_TOKEN = "<JIRA_API_TOKEN>" }

# codex mcp add atlassian --env CONFLUENCE_URL='<CONFLUENCE_URL>' --env CONFLUENCE_USERNAME='<CONFLUENCE_USERNAME>' --env CONFLUENCE_API_TOKEN='<CONFLUENCE_API_TOKEN>' --env JIRA_URL='<JIRA_URL>' --env JIRA_USERNAME='<JIRA_USERNAME>' --env JIRA_API_TOKEN='<JIRA_API_TOKEN>' -- docker run -i --rm -e CONFLUENCE_URL -e CONFLUENCE_USERNAME -e CONFLUENCE_API_TOKEN -e JIRA_URL -e JIRA_USERNAME -e JIRA_API_TOKEN ghcr.io/sooperset/mcp-atlassian:latest

~/.cursor/mcp.json

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
      }
    }
  }
}

.vscode/mcp.json

{
  "servers": {
    "atlassian": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
      }
    }
  }
}

~/.gemini/settings.json

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
      }
    }
  }
}

claude_desktop_config.json

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
      }
    }
  }
}

.trae/mcp.json

{
  "mcpServers": {
    "atlassian": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CONFLUENCE_URL",
        "-e",
        "CONFLUENCE_USERNAME",
        "-e",
        "CONFLUENCE_API_TOKEN",
        "-e",
        "JIRA_URL",
        "-e",
        "JIRA_USERNAME",
        "-e",
        "JIRA_API_TOKEN",
        "ghcr.io/sooperset/mcp-atlassian:latest"
      ],
      "env": {
        "CONFLUENCE_URL": "<CONFLUENCE_URL>",
        "CONFLUENCE_USERNAME": "<CONFLUENCE_USERNAME>",
        "CONFLUENCE_API_TOKEN": "<CONFLUENCE_API_TOKEN>",
        "JIRA_URL": "<JIRA_URL>",
        "JIRA_USERNAME": "<JIRA_USERNAME>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>"
      }
    }
  }
}

Environment variables

CONFLUENCE_URL
CONFLUENCE_USERNAME
CONFLUENCE_API_TOKEN
JIRA_URL
JIRA_USERNAME
JIRA_API_TOKEN

Replace the placeholders with your own credentials and keep them out of version control.

Setup

Environment variables

Related