Integrates with Atlassian's ecosystem, particularly Jira and Confluence, allowing AI assistants to interact with these tools directly through the MCP protocol.
Supports finding Bitbucket repository URLs (both cloud and self-hosted) in Jira issues through the extract-confluence-links tool.
Provides tools for listing, viewing, creating, and updating Confluence pages, adding comments, searching content using CQL, retrieving specific pages, and asking questions about page content with AI-powered analysis and summarization.
Provides capability to extract Git repository URLs from various hosting platforms and SSH Git URLs from Jira issues.
Supports extracting GitHub repository URLs from Jira issues, including links found in issue descriptions, comments, and remote links.
Enables extraction of GitLab repository URLs from Jira issues, including links in descriptions, comments, and remote links.
Enables listing, viewing, creating, and managing Jira issues, adding comments, transitioning issues between statuses, retrieving assigned tickets by priority, generating issue summaries, and extracting Confluence and Git links from issues.
MCP Server for Jira and Confluence
A Model Context Protocol (MCP) server that integrates with Atlassian's Jira and Confluence, enabling AI assistants to interact with these tools directly.
Features
Jira Integration
List recent issues
View issue details including comments
Create new issues
Add comments to issues
Transition issues between statuses
Get assigned issues - Retrieve your assigned tickets ordered by priority and date
Summarize issues - Get comprehensive issue summaries with comments and history
Extract Confluence and Git links - Find all Confluence page references and Git repository URLs in issues
Confluence Integration
List recent pages
View page content
Create new pages
Update existing pages
Add comments to pages
Search pages using CQL (Confluence Query Language)
Get specific pages by ID or title
Ask questions about page content
AI-Powered Prompts
Summarize Jira issues
Create structured Jira issue descriptions
Summarize Confluence pages
Generate structured Confluence content
Installation
Clone the repository
Install dependencies using
uv
:
Configuration
Environment Variables
Set the following environment variables to configure the server:
Jira Configuration
JIRA_URL
: Base URL of your Jira instance (e.g.,https://yourcompany.atlassian.net
)JIRA_USERNAME
: Your Jira username/emailJIRA_API_TOKEN
: Your Jira API token or passwordJIRA_PERSONAL_TOKEN
: Personal access token (alternative to username/API token)
Confluence Configuration
CONFLUENCE_URL
: Base URL of your Confluence instance (e.g.,https://yourcompany.atlassian.net/wiki
)CONFLUENCE_USERNAME
: Your Confluence username/emailCONFLUENCE_API_TOKEN
: Your Confluence API token or passwordCONFLUENCE_PERSONAL_TOKEN
: Personal access token (alternative to username/API token)
Quick Setup
Create API tokens from your Atlassian account settings
Set environment variables in your shell:
Or use the provided
run.sh
script with environment variables
Usage
Starting the Server
Run the server directly:
VSCode MCP Extension
If using with the VSCode MCP extension, the server is automatically configured via .vscode/mcp.json
.
Claude Desktop
To use with Claude Desktop, add the following configuration:
On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
Resources
The server exposes the following types of resources:
jira://issue/{ISSUE_KEY}
- Jira issuesconfluence://page/{PAGE_ID}
- Confluence pagesconfluence://space/{SPACE_KEY}/page/{PAGE_ID}
- Confluence pages with space key
Usage
Available Tools
Jira Tools
create-jira-issue
: Create a new Jira issuecomment-jira-issue
: Add a comment to an issuetransition-jira-issue
: Change an issue's statusget-jira-issue
: Get detailed information about a specific Jira issueget-my-assigned-issues
: Get issues assigned to you, ordered by priority and datesummarize-jira-issue
: Get comprehensive issue summary with comments and historyextract-confluence-links
: Find all Confluence and Git repository links in an issue
Confluence Tools
create-confluence-page
: Create a new Confluence pageupdate-confluence-page
: Update an existing page (version auto-fetched if not provided)comment-confluence-page
: Add a comment to a pageget-confluence-page
: Get a specific page with optional comments/historysearch-confluence
: Search pages using CQL queriesask-confluence-page
: Ask questions about page content
Usage Examples
Getting Your Assigned Issues
Getting a Specific Jira Issue
Summarizing a Jira Issue
Extracting Links from Issues
Getting a Confluence Page
Searching Confluence Pages
Asking Questions About Pages
Common CQL Query Examples
Simple text search:
"API Documentation"
(searches in content and title)Search by title:
title ~ "API Documentation"
Search in space:
space.key = "DEV"
Recent pages:
lastmodified >= now("-7d")
By author:
creator = "john.doe"
Combined:
title ~ "API" AND space.key = "DEV" AND lastmodified >= now("-30d")
Text in content:
text ~ "authentication method"
Note: All queries automatically include type = page
unless explicitly specified otherwise.
Available Prompts
AI-Powered Analysis
summarize-jira-issue
: Create a summary of a Jira issuecreate-jira-description
: Generate a structured issue descriptionsummarize-confluence-page
: Create a summary of a Confluence pagecreate-confluence-content
: Generate structured Confluence contentanswer-confluence-question
: Answer questions about specific page content
Context Types for Question Answering
summary
: Quick answers using first 1000-1500 charactersdetails
: Comprehensive answers using full page contentspecific
: Full content with enhanced filtering (future feature)
For detailed Confluence tool documentation and advanced CQL examples, see CONFLUENCE_TOOLS.md.
Practical Examples
Workflow: Research and Documentation
Search for relevant pages: Use
search-confluence
to find pages related to your topicGet page details: Use
get-confluence-page
to retrieve full content with commentsAsk specific questions: Use
ask-confluence-page
to extract specific informationCreate summaries: Use
summarize-confluence-page
prompt for quick overviews
Common Use Cases
Finding Documentation
Getting Page Information
Content Analysis
Knowledge Extraction
Development
Building and Publishing
To prepare the package for distribution:
Sync dependencies and update lockfile:
Build package distributions:
This will create source and wheel distributions in the dist/
directory.
Publish to PyPI:
Note: You'll need to set PyPI credentials via environment variables or command flags:
Token:
--token
orUV_PUBLISH_TOKEN
Or username/password:
--username
/UV_PUBLISH_USERNAME
and--password
/UV_PUBLISH_PASSWORD
Debugging
Since MCP servers run over stdio, debugging can be challenging. For the best debugging experience, we strongly recommend using the MCP Inspector.
You can launch the MCP Inspector via npm
with this command:
Upon launching, the Inspector will display a URL that you can access in your browser to begin debugging.
Changelog
Version 0.2.4 (2025-07-27)
Enhanced Confluence Search:
Smart CQL Query Builder - Automatically enhances simple search queries with proper CQL syntax:
Simple text queries - "API docs" becomes
(title ~ "API docs" OR text ~ "API docs")
Phrase detection - Longer queries become
text ~ "your search phrase"
Advanced CQL preservation - Complex queries with operators (AND, OR, ~, =) are used as-is
Space integration - Automatically adds space constraints when specified
Query transparency - Shows the enhanced CQL query in search results
Technical Improvements:
Added
build_smart_cql_query()
function for intelligent query enhancementEnhanced search-confluence tool description to explain automatic query enhancement
Better user experience with query transformation visibility
Improved search accuracy for both novice and advanced users
Version 0.2.3 (2025-07-27)
Enhanced Link Extraction:
Enhanced - Now extracts both Confluence pages AND Git repository URLs:
Git Repository Support - Detects URLs from GitHub, GitLab, Bitbucket, Azure DevOps, and other Git platforms
Smart Pattern Matching - Uses regex patterns to identify repository URLs in issue descriptions, comments, and remote links
Comprehensive Coverage - Scans all issue text fields for both Confluence and Git references
Rich Output - Returns organized lists of both Confluence pages and Git repositories with context
Technical Improvements:
Added
_extract_git_urls_from_text()
method with support for major Git platformsEnhanced URL extraction patterns for better accuracy
Improved tool description and documentation
Better organization of extracted links by type (Confluence vs Git)
Version 0.2.2 (2025-07-27)
New Jira Tools:
get-my-assigned-issues
- Get issues assigned to you ordered by priority (highest first) and creation date (newest first)Configurable max results (default: 25, max: 100)
Option to include completed/closed issues
Rich formatting with status, priority, type, dates
summarize-jira-issue
- Comprehensive issue analysis including:Complete issue details (status, priority, assignee, dates)
Full description and recent comments (last 5)
Confluence page references from remote links
Formatted as markdown for easy AI processing
extract-confluence-links
- Find all Confluence page references in issues:Scans issue description, all comments, and remote links
Supports multiple Confluence URL patterns (atlassian.net, custom domains)
Returns link titles, URLs, and source context
Technical Enhancements:
Added
get_current_user()
API method for user contextEnhanced JQL queries with proper field selection and ordering
Robust URL extraction with regex pattern matching
Improved error handling for missing or invalid issues
Better date formatting for human readability
Version 0.2.1 (2025-07-27)
Formatting Fixes:
Fixed 400 Bad Request errors with complex markdown formatting in Confluence pages
Implemented intelligent complexity detection - automatically chooses conversion strategy
Added robust error handling with graceful fallbacks for conversion failures
Enhanced list processing with proper HTML grouping and nesting
Version 0.2.0 (2025-07-27)
Major Improvements:
Fixed EmbeddedResource validation errors - All tools now use the correct MCP structure with
type: "resource"
and properTextResourceContents
formatEnhanced Confluence formatting - Dramatically improved markdown to Confluence conversion:
Proper list handling (grouped
<ul>
/<ol>
tags instead of individual ones)Better code block formatting with language support
Improved inline formatting (bold, italic, code, links)
Smarter paragraph handling
More robust markdown detection patterns
Fixed HTTP 409 conflicts - Made version parameter optional in
update-confluence-page
with automatic version fetchingAdded missing Confluence tools - Implemented
get-confluence-page
andsearch-confluence-pages
with proper CQL supportImproved error handling - Better error messages and validation throughout
Technical Changes:
Rewrote
ConfluenceFormatter.markdown_to_confluence()
with line-by-line processingAdded regex-based markdown detection with multiple pattern matching
Enhanced
_process_inline_formatting()
helper for consistent formattingImproved version conflict resolution in page updates
Added comprehensive logging for format detection and conversion
Version 0.1.9 (2025-07-26)
Initial PyPI release with basic Jira and Confluence functionality
Fixed basic EmbeddedResource structure issues
Added core tool implementations
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that integrates with Atlassian's Jira and Confluence, enabling AI assistants to interact with these tools directly through features like issue management, page creation, and content search.
Related MCP Servers
- -securityAlicense-qualityModel Context Protocol server for integrating with Atlassian products (Confluence and Jira) that supports both Atlassian Cloud and Server/Data Center deployments.
- -securityFlicense-qualityModel Context Protocol server that allows AI assistants to interact with Jira, supporting operations like creating tickets and fetching project information directly from the cursor.Last updated -1
- -securityAlicense-qualityA Model Context Protocol server that connects AI assistants like Cline to Atlassian Jira and Confluence, enabling them to query data and perform actions through a standardized interface.Last updated -3041MIT License
- AsecurityFlicenseAqualityA Model Context Protocol server that enables AI assistants to create and manage JIRA issues with rich markdown formatting and automatic conversion to Atlassian Document Format.Last updated -4