atlassian-mcp

Integrates Jira and Confluence operations through MCP servers using JQL and CQL queries.

Updated Mar 9, 2026
One-click install
npx skills add https://github.com/ArMaTeC/Redball --skill atlassian-mcp-armatec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: atlassian-mcp
Source: https://github.com/ArMaTeC/Redball/tree/main/.devin/skills/atlassian-mcp
Command: npx skills add https://github.com/ArMaTeC/Redball --skill atlassian-mcp-armatec

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Connecting AI assistants to Jira and Confluence requires navigating multiple MCP server options, authentication methods, and query languages, which is error-prone and time-consuming without structured guidance. ## Core Features & Use Cases - MCP Server Setup: Configure official, sooperset, or self-hosted Atlassian MCP servers with OAuth 2.1, API tokens, or PAT authentication. - Jira Operations: Write and validate JQL queries, create and update issues, manage sprints, and build issue-linking dependency chains. - Confluence Operations: Search content with CQL, create and update pages with storage-format macros, and manage labels and comments. - Use Case: Automate a sprint retrospective by querying completed sprint issues via JQL, calculating velocity metrics, and generating a formatted Confluence retro page with embedded Jira macros. ## Quick Start Set up an Atlassian MCP server connection and show me all open bugs assigned to me in the current sprint.

Frequently Asked Questions about atlassian-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up an Atlassian MCP server for Jira and Confluence?▼

Add an MCP server entry to your client configuration with the server command and environment variables for JIRA_URL, credentials, and CONFLUENCE_URL. Choose the official server for cloud with OAuth, or sooperset's mcp-atlassian for Server/Data Center support with PAT authentication.

How do I write JQL queries to search Jira issues?▼

JQL uses field-operator-value syntax like project = PROJ AND status = "In Progress" ORDER BY priority DESC. Validate queries with maxResults=1 before full execution, and quote multi-word values like status names.

What is the difference between OAuth 2.1 and API tokens for Atlassian?▼

OAuth 2.1 suits user-facing applications with scoped permissions and refresh tokens, while API tokens work for personal automation scripts using Basic auth with email and token. PATs are the equivalent for Server/Data Center deployments.

Does the Atlassian MCP server support Jira Server or Data Center?▼

The official Atlassian MCP server supports cloud products only. For Jira Server or Data Center, use the sooperset mcp-atlassian server, which supports Personal Access Token authentication against self-hosted instances.

Why does my Jira issue link show the wrong direction?▼

The jira_create_issue_link tool uses counterintuitive parameters: inward_issue_key is the blocker and outward_issue_key is the blocked issue. Verify links after creation by checking that the blocker displays "blocks" the other issue.

How do I handle Atlassian API rate limits in automation?▼

Implement exponential backoff with retries and respect the Retry-After header on 429 responses. Use pagination of 50-100 items per request and add delays between bulk operations to stay within limits.