Skip to content
atlassian-mcp logo

Atlassian MCP Server for JIRA

atlassian-mcp

Use the Atlassian MCP Server to interact with JIRA from coding agents (Cursor, Claude Code). This skill documents how to use the official Atlassian MCP server for JIRA and Confluence operations. Enable this MCP server in your Cursor/Claude Code settings for JIRA access.

SKILL.md

Full skill instructions

Atlassian MCP Server for JIRA

The Atlassian MCP Server provides direct access to JIRA and Confluence from coding agents. This is the supported way to access Atlassian data from Cursor or Claude Code.

Setup

In Cursor

The Atlassian MCP Server is already configured globally. To enable it:

  1. Open Cursor Settings
  2. Go to Tools & MCP
  3. Enable "Atlassian-MCP-Server"

Configuration location: ~/​.cursor/​mcp.json

{
  "mcpServers": {
    "Atlassian-MCP-Server": {
      "url": "https://mcp.atlassian.com/​v1/​sse"
    }
  }
}

In Claude Code

Add to your Claude Code MCP settings:

{
  "mcpServers": {
    "Atlassian-MCP-Server": {
      "url": "https://mcp.atlassian.com/​v1/​sse"
    }
  }
}

Available Tools

When enabled, the Atlassian MCP Server provides these tools:

Issue Operations

ToolDescription
mcp_Atlassian_getJiraIssueGet details of a specific issue
mcp_Atlassian_createJiraIssueCreate a new issue
mcp_Atlassian_editJiraIssueUpdate an existing issue
mcp_Atlassian_transitionJiraIssueChange issue status
mcp_Atlassian_searchJiraIssuesUsingJqlSearch issues with JQL

Comments

ToolDescription
mcp_Atlassian_addCommentToJiraIssueAdd a comment to an issue
mcp_Atlassian_getJiraIssueCommentsGet comments from an issue

Confluence (if enabled)

ToolDescription
mcp_Atlassian_createConfluencePageCreate a Confluence page
mcp_Atlassian_getConfluencePageGet a Confluence page
mcp_Atlassian_searchConfluenceSearch Confluence

Common Patterns

Get Issue Details

Use mcp_Atlassian_getJiraIssue with issueKey: "PROJ-123"

Search for Issues

Use mcp_Atlassian_searchJiraIssuesUsingJql with:
  jql: "project = YOUR_PROJECT AND component = 'YOUR_COMPONENT' AND status = 'In Progress'"

Create an Issue

Use mcp_Atlassian_createJiraIssue with:
  project: "YOUR_PROJECT"
  issueType: "Story"
  summary: "Implement new feature"
  description: "Description of the feature"
  components: ["YOUR_COMPONENT"]

Transition Issue Status

Use mcp_Atlassian_transitionJiraIssue with:
  issueKey: "PROJ-123"
  transition: "In Progress"

Add Comment

Use mcp_Atlassian_addCommentToJiraIssue with:
  issueKey: "PROJ-123"
  comment: "Started working on this issue"

JQL Quick Reference

Common JQL queries for the Orient Task Force:

# All issues for YOUR_COMPONENT
project = YOUR_PROJECT AND component = "YOUR_COMPONENT"

# In Progress issues
project = YOUR_PROJECT AND component = "YOUR_COMPONENT" AND status = "In Progress"

# Blockers
project = YOUR_PROJECT AND component = "YOUR_COMPONENT" AND (priority = Blocker OR labels = blocked)

# Recent issues (last 7 days)
project = YOUR_PROJECT AND component = "YOUR_COMPONENT" AND created >= -7d

# My issues
project = YOUR_PROJECT AND component = "YOUR_COMPONENT" AND assignee = currentUser()

# Sprint issues
project = YOUR_PROJECT AND component = "YOUR_COMPONENT" AND sprint in openSprints()

Troubleshooting

"Tool not found" Error

Make sure the Atlassian MCP Server is enabled in your IDE settings. The tools won't appear until the server is connected.

Authentication Issues

The Atlassian MCP Server uses OAuth. If you're not authenticated:

  1. The tool will prompt you to authenticate
  2. Follow the OAuth flow in your browser
  3. Grant the necessary permissions

Rate Limits

The Atlassian MCP Server is subject to Atlassian's rate limits. If you hit limits:

  • Reduce query frequency
  • Use more specific JQL to reduce result sets
  • Cache results when appropriate

More skills from diegosouzapw

accessibility logo
diegosouzapw/awesome-omni-skill

accessibility

Accessibility guidelines for VS Code features — covers accessibility help dialogs, accessible views, verbosity settings, accessibility signals, ARIA alerts/status announcements, keyboard navigation, and ARIA labels/roles. Applies to both new interactive UI surfaces and updates to existing feature...

62 1
View
mermaid-diagrams logo
diegosouzapw/awesome-omni-skill

mermaid-diagrams

Mermaid diagram creation for flowcharts, sequences, ERDs, and more. Generate diagrams from text in markdown files. Use for documentation, architecture diagrams, and visual representations. Triggers on mermaid, flowchart, sequence diagram, ERD, entity relationship, gantt chart, pie chart, class di...

62 1
View
tauri2-react-rust logo
diegosouzapw/awesome-omni-skill

tauri2-react-rust

Guides development of cross-platform desktop apps with Tauri 2, TypeScript, React, and Rust. Use when building Tauri apps, implementing IPC, designing Rust backend or TypeScript/React frontend, when researching or cloning a website (open site, snapshot elements), when verifying local dev or built...

62 1
View
fp-ts-errors logo
diegosouzapw/awesome-omni-skill

fp-ts-errors

Handle errors as values using fp-ts Either and TaskEither for cleaner, more predictable TypeScript code. Use when implementing error handling patterns with fp-ts.

62 0
View
ring:pre-dev-research logo
diegosouzapw/awesome-omni-skill

ring:pre-dev-research

Gate 0 research phase for pre-dev workflow. Dispatches 3 parallel research agents to gather codebase patterns, external best practices, and framework documentation BEFORE creating PRD/TRD. Outputs research.md with file:line references.

62 0
View
create-assistant logo
diegosouzapw/awesome-omni-skill

create-assistant

Create and configure Vapi voice AI assistants with models, voices, transcribers, tools, hooks, and advanced settings. Use when building voice agents, phone bots, customer support assistants, or any conversational AI that handles phone or web calls.

62 0
View
codex-headless logo
diegosouzapw/awesome-omni-skill

codex-headless

Delegiere Aufgaben an OpenAI Codex CLI im Headless-Mode. Nutzt ChatGPT Subscription (KEIN API Key). Nur Workspace-Zugriff, KEIN System-Zugriff. Auto-Accept mit --full-auto. Web-Recherche mit --search.

62 0
View
social-media-scheduler logo
diegosouzapw/awesome-omni-skill

social-media-scheduler

Generate a full week of social media content for any topic. Outputs platform-optimized posts for Twitter/X, LinkedIn, and Instagram with hashtags and posting times.

62 0
View
Data Privacy Compliance logo
diegosouzapw/awesome-omni-skill

Data Privacy Compliance

Data privacy and regulatory compliance specialist for GDPR, CCPA, HIPAA, and international data protection laws. Use when implementing privacy controls, conducting data protection impact assessments, ensuring regulatory compliance, or managing data subject rights. Expert in consent management, da...

62 0
View
triple-review logo
diegosouzapw/awesome-omni-skill

triple-review

Reviews a task using the TRIPLE protocol, as the review agent.

62 0
View
Tech Stack & Architecture Decision logo
diegosouzapw/awesome-omni-skill

Tech Stack & Architecture Decision

Define and document the technology stack and architecture decisions for a project. Use when the user needs to choose a tech stack, make architecture decisions, define infrastructure choices, or document technology selections. Triggers on requests like "define the tech stack", "choose technologies...

62 0
View

Popular AI tools

Kaiber logo
Video

Kaiber

Generate, edit, and beat-sync AI video with leading models in one workspace.

Paid
View
Vimcal logo
Productivity

Vimcal

The world's fastest calendar for remote work

Free
View

Transform Your Design with AI Designer by ImgCreator.ai

Freemium
View
Akool AI logo
Content & writing

Akool AI

Revolutionizing Video Production with AI-Powered Creativity

Paid
View

Extend an image past the frame and let AI fill the new aspect ratio.

Freemium
View
StarByFace logo
Security

StarByFace

Discover your celebrity doppelgänger with StarByFace!

Free
View
C

ChainClarity explains 700+ crypto whitepapers in plain English, with layered summaries, comparisons, research tools, alerts, and a $4.99 Pro plan.

Freemium
View
Opus Clip logo
Coding & apps

Opus Clip

Opus.ai: Revolutionize Your Web Experience

Free
View