MCP Atlassian Server

This is a maintained fork of Vijay-Duke/mcp-atlassian

Why this fork exists: In January 2026, Atlassian removed the /rest/api/3/search endpoint entirely, breaking all Jira search functionality in the original package. This fork migrates to the new /rest/api/3/search/jql endpoint and implements the new cursor-based pagination. A PR has been submitted to upstream, but as of now there are 14+ unmerged PRs in that repo.

Install this fork: npm install @efithor/mcp-atlassian --registry=https://npm.pkg.github.com

A Model Context Protocol (MCP) server for integrating with Atlassian products (Confluence and Jira). This server provides tools for AI assistants to interact with Atlassian Cloud APIs, enabling document management, search, and export capabilities.

Features

Confluence Integration

• Read & Search: Access pages, spaces, and content
• Content Management: Create, update pages and comments
• Page Hierarchy: Navigate parent/child page relationships
• Export: Export pages as HTML or Markdown with embedded images
• Attachments: List, download, and upload attachments
• Labels: Manage page labels
• Users: Find and query users, track personal activity
• Personal Dashboard: View recent pages and mentions

Jira Integration

• Issues: Read and search issues, get personal tasks
• Projects: List and explore projects
• Boards & Sprints: List boards, view sprints, track active work
• Comments: Add comments to issues
• Issue Creation: Create new issues with custom fields
• User Management: Get current user details
• Personal Dashboard: View your open issues and sprint tasks

Installation

Option 1: GitHub Packages (Recommended)

First, configure npm to use GitHub Packages for the @efithor scope. Add to your ~/.npmrc:

@efithor:registry=https://npm.pkg.github.com

Then install:

# Install globally
npm install -g @efithor/mcp-atlassian

# Or install locally
npm install @efithor/mcp-atlassian

Option 2: Clone and Build

# Clone this fork
git clone https://github.com/Efithor/mcp-atlassian.git
cd mcp-atlassian

# Install dependencies
npm install

# Build TypeScript
npm run build

Option 3: Install Directly from GitHub

# Install directly from this fork
npm install -g github:Efithor/mcp-atlassian

# Or install in your project
npm install github:Efithor/mcp-atlassian

Configuration

Environment Variables

Create a .env file in the root directory:

ATLASSIAN_BASE_URL=https://yourdomain.atlassian.net
[email protected]
ATLASSIAN_API_TOKEN=your-api-token

Getting API Token