📌Overview

Purpose: The MCP Atlassian framework serves to facilitate seamless integration between Atlassian products, namely Confluence and Jira, enhancing productivity and collaboration.

Overview: The Model Context Protocol (MCP) server for Atlassian products supports both cloud and server/data center deployments. It allows for efficient interaction with Confluence and Jira by providing a set of tools to manage project documentation and issue tracking within a unified platform.

Key Features:

Multi-Deployment Support: Fully supports both Cloud and Server/Data Center versions of Confluence (7.9+) and Jira (8.14+), ensuring flexibility in product usage.
Comprehensive Toolset: Offers various API tools for operations in Confluence and Jira, including searching, creating, updating, and deleting pages/issues, enhancing operational efficiencies.
Customizable Configuration: Users can easily configure the MCP server with command line arguments or environment variables, making it adaptable to different user needs and environments.

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.

Compatibility

Product	Deployment Type	Support Status
Confluence	Cloud	✅ Fully supported
Confluence	Server/Data Center	✅ Supported (version 7.9+)
Jira	Cloud	✅ Fully supported
Jira	Server/Data Center	✅ Supported (version 8.14+)

Setup Guide

1. Authentication Setup

Generate authentication tokens for Confluence & Jira:

For Cloud

Go to Atlassian API tokens
Click Create API token, name it
Copy the token immediately

For Server/Data Center

Go to your profile → Profile → Personal Access Tokens
Click Create token, name it, set expiry
Copy the token immediately

2. Installation

Choose an installation method:

# 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 .

3. Configuration and Usage

Configure the MCP server using command line arguments for either Confluence, Jira, or both.

Required Arguments

For Cloud:

uvx mcp-atlassian \
  --confluence-url https://your-company.atlassian.net/wiki \
  --confluence-username your.email@company.com \
  --confluence-token your_api_token \
  --jira-url https://your-company.atlassian.net \
  --jira-username your.email@company.com \
  --jira-token your_api_token

For Server/Data Center:

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.

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.
--jira-projects-filter: Comma-separated list of project keys to filter Jira search results.
--read-only: Run in read-only mode.
--verbose: Increase logging verbosity.

IDE Integration

Cloud Setup

Using uvx (recommended):

{
  "mcpServers": {
    "mcp-atlassian": {
      "command": "uvx",
      "args": [
        "mcp-atlassian",
        "--confluence-url=https://your-company.atlassian.net/wiki",
        "--confluence-username=your.email@company.com",
        "--confluence-token=your_api_token",
        "--jira-url=https://your-company.atlassian.net",
        "--jira-username=your.email@company.com",
        "--jira-token=your_api_token"
      ]
    }
  }
}

Resources

The MCP server filters resources to show only Confluence spaces and Jira projects that the user is interacting with.

confluence://{space_key}: Access Confluence spaces
jira://{project_key}: Access Jira projects

Available Tools

Tool	Description
`confluence_search`	Search Confluence content
`confluence_get_page`	Get content of a specific Confluence page
`jira_get_issue`	Get details of a specific Jira issue
`jira_create_issue`	Create a new issue in Jira
`jira_update_issue`	Update an existing Jira issue

Security

Never share API tokens.
Keep .env files secure and private.

License

Licensed under MIT - see LICENSE file. This is not an official Atlassian product.