Installation

Install and configure MCP Atlassian using uvx, Docker, pip, or from source

MCP Atlassian can be installed using several methods. Choose the one that best fits your workflow.

uvx (Recommended)

The simplest way to run MCP Atlassian without permanent installation using uvx:

# Run directly (downloads on first use, cached for subsequent runs)
uvx mcp-atlassian --help

# Run with a specific Python version if needed
uvx --python=3.12 mcp-atlassian --help

IDE Configuration with uvx

Claude Desktop

Edit your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": ["mcp-atlassian"],
      "env": {
        "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[e-mail]",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[e-mail]",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

Cursor

Open Settings → MCP → + Add new global MCP server, then use the same JSON configuration.

Docker

Docker provides an isolated environment and is recommended for production deployments or when you need specific version control.

# Pull the latest image
docker pull ghcr.io/sooperset/mcp-atlassian:latest

# Run with environment variables
docker run --rm -i \
  -e JIRA_URL=https://your-company.atlassian.net \
  -e JIRA_USERNAME=[e-mail] \
  -e JIRA_API_TOKEN=your_api_token \
  ghcr.io/sooperset/mcp-atlassian:latest

IDE Configuration with Docker

{
  "mcpServers": {
    "mcp-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": "https://your-company.atlassian.net/wiki",
        "CONFLUENCE_USERNAME": "[e-mail]",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "[e-mail]",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}

See Configuration for more Docker options including environment files.

pip

Install directly with pip for development or when you need the package in your Python environment:

pip install mcp-atlassian

# Include this extra when PAC/WPAD proxy routing is enabled
pip install "mcp-atlassian[wpad]"

# Run the server
mcp-atlassian --help

uv

If you’re using uv for package management:

# Add to your project
uv add mcp-atlassian

# Include this extra when PAC/WPAD proxy routing is enabled
uv add "mcp-atlassian[wpad]"

# Run
uv run mcp-atlassian --help

From Source

For development or contributing:

git clone https://github.com/sooperset/mcp-atlassian.git
cd mcp-atlassian
uv sync --frozen --all-extras --dev
uv run mcp-atlassian --help

See CONTRIBUTING.md for development setup details.