https://github.com/sooperset/mcp-atlassian

MCP server that integrates Confluence and Jira
https://github.com/sooperset/mcp-atlassian

atlassian confluence jira mcp

Last synced: 11 days ago
JSON representation

MCP server that integrates Confluence and Jira

Host: GitHub
URL: https://github.com/sooperset/mcp-atlassian
Owner: sooperset
License: mit
Created: 2024-12-03T09:25:20.000Z (5 months ago)
Default Branch: main
Last Pushed: 2025-04-01T16:25:15.000Z (19 days ago)
Last Synced: 2025-04-01T17:36:45.052Z (19 days ago)
Topics: atlassian, confluence, jira, mcp
Language: Python
Homepage:
Size: 575 KB
Stars: 536
Watchers: 4
Forks: 91
Open Issues: 21
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md

Awesome Lists containing this project

awesome-mcp-servers - Atlassian - Comprehensive integration with Atlassian suite including Confluence for documentation management and Jira for issue tracking. (💬 <a name="communication"></a>Communication)
awesome-mcp-zh - sooperset/mcp-atlassian
awesome-mcp-servers - sooperset/mcp-atlassian - MCP server for Atlassian products (Confluence and Jira). Supports Confluence Cloud, Jira Cloud, and Jira Server/Data Center. Provides comprehensive tools for searching, reading, creating, and managing content across Atlassian workspaces. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
awesome-mcp-servers - sooperset/mcp-atlassian - MCP server for Atlassian products (Confluence and Jira). Supports Confluence Cloud, Jira Cloud, and Jira Server/Data Center. Provides comprehensive tools for searching, reading, creating, and managing content across Atlassian workspaces. (Legend / 🛠️ <a name="other-tools-and-integrations"></a>Other Tools and Integrations)
Awesome-MCP-Servers-directory - Atlassian - Interact with Atlassian Cloud products (Confluence and Jira) including searching/reading Confluence spaces/pages, accessing Jira issues, and project metadata (Other Tools and Integrations)
awesome-mcp-servers - sooperset/mcp-atlassian - Confluenceワークスペースの自然言語検索とコンテンツアクセス (サーバー実装 / 🛠️ <a name="other-tools-and-integrations"></a>その他のツールと統合)
awesome-mcp-servers - Atlassian MCP Server - MCP server that integrates Confluence and Jira (Table of Contents / Workflow Automation)
awesome-mcp-servers - Atlassian MCP Server - MCP server that integrates Confluence and Jira (Table of Contents / Workflow Automation)

README

        # MCP Atlassian

![PyPI Version](https://img.shields.io/pypi/v/mcp-atlassian)

![PyPI - Downloads](https://img.shields.io/pypi/dm/mcp-atlassian)

![PePy - Total Downloads](https://static.pepy.tech/personalized-badge/mcp-atlassian?period=total&units=international_system&left_color=grey&right_color=blue&left_text=Total%20Downloads)

![License](https://img.shields.io/github/license/sooperset/mcp-atlassian)

[![smithery badge](https://smithery.ai/badge/mcp-atlassian)](https://smithery.ai/server/mcp-atlassian)

Model Context Protocol (MCP) server for Atlassian products (Confluence and Jira). This integration supports both Confluence & Jira Cloud and Server/Data Center deployments.

### Feature Demo

![Jira Demo](https://github.com/user-attachments/assets/61573853-c8a8-45c9-be76-575f2b651984)

Confluence Demo

https://github.com/user-attachments/assets/7fe9c488-ad0c-4876-9b54-120b666bb785

### Compatibility

| Product | Deployment Type | Support Status              |

|---------|----------------|-----------------------------|

| **Confluence** | Cloud | ✅ Fully supported           |

| **Confluence** | Server/Data Center | ✅ Supported (version 6.0+)  |

| **Jira** | Cloud | ✅ Fully supported           |

| **Jira** | Server/Data Center | ✅ Supported (version 8.14+) |

## Setup Guide

### 1. Authentication Setup

First, generate the necessary authentication tokens for Confluence & Jira:

#### For Cloud

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens

2. Click **Create API token**, name it

3. Copy the token immediately

#### For Server/Data Center

1. Go to your profile (avatar) → **Profile** → **Personal Access Tokens**

2. Click **Create token**, name it, set expiry

3. Copy the token immediately

### 2. Installation

Choose one of these installation methods:

```bash

# Using uv (recommended)

brew install uv

uvx mcp-atlassian

# Using pip

pip install mcp-atlassian

# Using Docker

git clone https://github.com/sooperset/mcp-atlassian.git

cd mcp-atlassian

docker build -t mcp/atlassian .

# Using Smithery

npx -y @smithery/cli install mcp-atlassian --client claude

```

### 3. Configuration and Usage

You can configure the MCP server using command line arguments. The server supports using either Confluence, Jira, or both services - include only the arguments needed for your use case.

#### Required Arguments

For Cloud:

```bash

uvx mcp-atlassian \

  --confluence-url https://your-company.atlassian.net/wiki \

  --confluence-username [email protected] \

  --confluence-token your_api_token \

  --jira-url https://your-company.atlassian.net \

  --jira-username [email protected] \

  --jira-token your_api_token

```

For Server/Data Center:

```bash

uvx mcp-atlassian \

  --confluence-url https://confluence.your-company.com \

  --confluence-personal-token your_token \

  --jira-url https://jira.your-company.com \

  --jira-personal-token your_token

```

> **Note:** You can configure just Confluence, just Jira, or both services. Simply include only the arguments for the service(s) you want to use. For example, to use only Confluence Cloud, you would only need `--confluence-url`, `--confluence-username`, and `--confluence-token`.

#### Optional Arguments

- `--transport`: Choose transport type (`stdio` [default] or `sse`)

- `--port`: Port number for SSE transport (default: 8000)

- `--[no-]confluence-ssl-verify`: Toggle SSL verification for Confluence Server/DC

- `--[no-]jira-ssl-verify`: Toggle SSL verification for Jira Server/DC

- `--confluence-spaces-filter`: Comma-separated list of space keys to filter Confluence search results (e.g., "DEV,TEAM,DOC")

- `--jira-projects-filter`: Comma-separated list of project keys to filter Jira search results (e.g., "PROJ,DEV,SUPPORT")

- `--read-only`: Run in read-only mode (disables all write operations)

- `--verbose`: Increase logging verbosity (can be used multiple times, default is WARNING level)

  - `-v` or `--verbose`: Set logging to INFO level

  - `-vv` or `--verbose --verbose`: Set logging to DEBUG level

> **Note:** All configuration options can also be set via environment variables. See the `.env.example` file in the repository for the full list of available environment variables.

## IDE Integration

### Claude Desktop Setup

Using uvx (recommended) - Cloud:

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://your-company.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token",

        "--jira-url=https://your-company.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

Using uvx (recommended) - Server/Data Center 

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://confluence.your-company.com",

        "--confluence-personal-token=your_token",

        "--jira-url=https://jira.your-company.com",

        "--jira-personal-token=your_token"

      ]

    }

  }

}

```

Using uvx - Confluence with Basic Auth (older servers)

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://confluence.your-company.com",

        "[email protected]",

        "--confluence-token=your_password"

      ]

    }

  }

}

```

Using uvx - Confluence only

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://your-company.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token"

      ]

    }

  }

}

```

Using uvx - Jira only

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--jira-url=https://your-company.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

Using pip

> Note: Examples below use Cloud configuration. For Server/Data Center, use the corresponding arguments (--confluence-personal-token, --jira-personal-token) as shown in the Configuration section above.

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "mcp-atlassian",

      "args": [

        "--confluence-url=https://your-company.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token",

        "--jira-url=https://your-company.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

Using docker

> Note: Examples below use Cloud configuration. For Server/Data Center, use the corresponding arguments (--confluence-personal-token, --jira-personal-token) as shown in the Configuration section above.

There are two ways to configure the Docker environment:

1. Using cli arguments directly in the config:

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "docker",

      "args": [

        "run",

        "--rm",

        "-i",

        "mcp/atlassian",

        "--confluence-url=https://your-company.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token",

        "--jira-url=https://your-company.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

2. Using an environment file:

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "docker",

      "args": [

        "run",

        "--rm",

        "-i",

        "--env-file",

        "/path/to/your/.env",

        "mcp/atlassian"

      ]

    }

  }

}

```

### Cursor IDE Setup

1. Open Cursor Settings

2. Navigate to `Features` > `MCP Servers` (or directly to `MCP`)

3. Click `+ Add new global MCP server`

This will create or edit the `~/.cursor/mcp.json` file with your MCP server configuration.

![Cursor MCP Configuration](https://github.com/user-attachments/assets/d0901421-7359-4f3f-8330-a82fc574a015)

#### JSON Configuration for stdio Transport

For Cloud:

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://your-company.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token",

        "--jira-url=https://your-company.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

Server/Data Center Configuration

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uvx",

      "args": [

        "mcp-atlassian",

        "--confluence-url=https://confluence.your-company.com",

        "--confluence-personal-token=your_token",

        "--jira-url=https://jira.your-company.com",

        "--jira-personal-token=your_token"

      ]

    }

  }

}

```

#### SSE Transport Configuration

For SSE transport, first start the server with its configuration provided via command-line arguments or server-side environment variables (e.g., from a `.env` file):

```bash

# Example starting the server with Cloud configuration

uvx mcp-atlassian --transport sse --port 9000 \

  --confluence-url https://your-company.atlassian.net/wiki \

  --confluence-username [email protected] \

  --confluence-token your_api_token \

  --jira-url https://your-company.atlassian.net \

  --jira-username [email protected] \

  --jira-token your_api_token

```

Then configure *only the URL* in Cursor's `~/.cursor/mcp.json`:

```json

{

  "mcpServers": {

    "mcp-atlassian-sse": {

      "url": "http://localhost:9000/sse"

    }

  }

}

```

## Resources

> **Note:** The MCP server filters resources to only show Confluence spaces and Jira projects that the user is actively interacting with, based on their contributions and assignments.

- `confluence://{space_key}`: Access Confluence spaces

- `jira://{project_key}`: Access Jira projects

## Available Tools

| Tool | Description |

|------|-------------|

| `confluence_search` | Search Confluence content using CQL |

| `confluence_get_page` | Get content of a specific Confluence page |

| `confluence_get_page_children` | Get child pages of a specific Confluence page |

| `confluence_get_page_ancestors` | Get parent pages of a specific Confluence page |

| `confluence_get_comments` | Get comments for a specific Confluence page |

| `confluence_create_page` | Create a new Confluence page |

| `confluence_update_page` | Update an existing Confluence page |

| `confluence_delete_page` | Delete an existing Confluence page |

| `confluence_attach_content` | Attach content to a Confluence page |

| `jira_get_issue` | Get details of a specific Jira issue |

| `jira_search` | Search Jira issues using JQL |

| `jira_get_project_issues` | Get all issues for a specific Jira project |

| `jira_get_epic_issues` | Get all issues linked to a specific Epic |

| `jira_create_issue` | Create a new issue in Jira |

| `jira_update_issue` | Update an existing Jira issue |

| `jira_delete_issue` | Delete an existing Jira issue |

| `jira_get_transitions` | Get available status transitions for a Jira issue |

| `jira_transition_issue` | Transition a Jira issue to a new status |

| `jira_add_comment` | Add a comment to a Jira issue |

| `jira_add_worklog` | Add a worklog entry to a Jira issue |

| `jira_get_worklog` | Get worklog entries for a Jira issue |

| `jira_download_attachments` | Download attachments from a Jira issue |

| `jira_link_to_epic` | Link an issue to an Epic |

| `jira_get_agile_boards` | Get Jira agile boards by name, project key, or type |

| `jira_get_board_issues` | Get all issues linked to a specific board |

| `jira_get_sprints_from_board` | Get Jira sprints from board by state |

| `jira_get_sprint_issues` | Get Jira issues from sprint |

## Development & Debugging

### Local Development Setup

If you've cloned the repository and want to run a local version:

For Cloud:

```json

{

  "mcpServers": {

    "mcp-atlassian": {

      "command": "uv",

      "args": [

        "--directory", "/path/to/your/mcp-atlassian",

        "run", "mcp-atlassian",

        "--confluence-url=https://your-domain.atlassian.net/wiki",

        "[email protected]",

        "--confluence-token=your_api_token",

        "--jira-url=https://your-domain.atlassian.net",

        "[email protected]",

        "--jira-token=your_api_token"

      ]

    }

  }

}

```

### Debugging Tools

```bash

# Using MCP Inspector

# For installed package

npx @modelcontextprotocol/inspector uvx mcp-atlassian ...

# For local development version

npx @modelcontextprotocol/inspector uv --directory /path/to/your/mcp-atlassian run mcp-atlassian ...

# View logs

tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

```

## Security

- Never share API tokens

- Keep .env files secure and private

- See [SECURITY.md](SECURITY.md) for best practices

## License

Licensed under MIT - see [LICENSE](LICENSE) file. This is not an official Atlassian product.

ecosyste.ms

Data

Tools

Indexes

Applications

Experiments

Awesome

https://github.com/sooperset/mcp-atlassian

Awesome Lists containing this project

README