---
title: "Installation"
description: "Install MCP Atlassian using uvx, Docker, pip, or from source"
---

# Installation

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](https://docs.astral.sh/uv/guides/tools/):

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

# Run with specific Python version (required for Python 3.14+)
uvx --python=3.12 mcp-atlassian --help
```

### IDE Configuration with uvx

<Tabs>
  <Tab title="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`

    ```json
    {
      "mcpServers": {
        "mcp-atlassian": {
          "command": "uvx",
          "args": ["mcp-atlassian"],
          "env": {
            "CONFLUENCE_URL": "https://your-company.atlassian.net/wiki",
            "CONFLUENCE_USERNAME": "your.email@company.com",
            "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
            "JIRA_URL": "https://your-company.atlassian.net",
            "JIRA_USERNAME": "your.email@company.com",
            "JIRA_API_TOKEN": "your_jira_api_token"
          }
        }
      }
    }
    ```
  </Tab>
  <Tab title="Cursor">
    Open **Settings** → **MCP** → **+ Add new global MCP server**, then use the same JSON configuration.
  </Tab>
</Tabs>

<Note>
Python 3.14 is not yet supported due to upstream pydantic-core/PyO3 limitations.
Use `["--python=3.12", "mcp-atlassian"]` as args if needed.
</Note>

## Docker

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

```bash
# 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=your.email@company.com \
  -e JIRA_API_TOKEN=your_api_token \
  ghcr.io/sooperset/mcp-atlassian:latest
```

### IDE Configuration with Docker

```json
{
  "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": "your.email@company.com",
        "CONFLUENCE_API_TOKEN": "your_confluence_api_token",
        "JIRA_URL": "https://your-company.atlassian.net",
        "JIRA_USERNAME": "your.email@company.com",
        "JIRA_API_TOKEN": "your_jira_api_token"
      }
    }
  }
}
```

See [Configuration](/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:

```bash
pip install mcp-atlassian

# Run the server
mcp-atlassian --help
```

## uv

If you're using [uv](https://docs.astral.sh/uv/) for package management:

```bash
# Add to your project
uv add mcp-atlassian

# Run
uv run mcp-atlassian --help
```

## From Source

For development or contributing:

```bash
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](https://github.com/sooperset/mcp-atlassian/blob/main/CONTRIBUTING.md) for development setup details.
