atlassian

Manage Jira issues and Confluence pages via REST API or Atlassian MCP server.

432|47|Updated Dec 22, 2025

Search Tags:#oauth #issue tracking #jira #atlassian #wiki #jql #confluence

Ready to run

npx skills add https://github.com/sanjay3290/ai-skills --skill atlassian-sanjay3290

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: atlassian
Source: https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian
Command: npx skills add https://github.com/sanjay3290/ai-skills --skill atlassian-sanjay3290

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires httpx, keyring, python-dotenv, and includes scripts (resource) components.

What problem does it solve? Working with Jira and Confluence from the command line or an AI assistant normally requires manual API calls, credential handling, and knowledge of JQL/CQL syntax. This Skill provides ready-to-use scripts that search, create, update, and transition Jira issues and manage Confluence pages, with authentication handled automatically. ## Core Features & Use Cases - Jira Issue Management: Search with JQL, create and update issues, transition workflow statuses, and add or list comments. - Confluence Page Management: Search with CQL, read page content, browse spaces and hierarchies, and create or update pages. - Dual Authentication: OAuth 2.1 via the Atlassian MCP server with auto-refreshing tokens, or API token auth stored in the system keyring. - Use Case: Ask your AI assistant to find all open bugs assigned to you in the DEV project, transition one to In Progress, and add a comment summarizing your fix. ## Quick Start Use the atlassian skill to search Jira for open issues in project DEV and show me the top ten results.

Frequently Asked Questions about atlassian

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

FAQPage Schema

How do I search Jira issues with JQL from the command line?▼

Run python scripts/jira.py search followed by your JQL query, such as "project = DEV AND status = Open". Add --limit to control result count and --json for machine-readable output.

How do I create and update Confluence pages programmatically?▼

Use python scripts/confluence.py create with --title and --space-id to create pages, and update with a page ID plus --title or --body. Page bodies use Confluence storage format HTML, and updates handle version increments automatically.

What authentication methods does the Atlassian API support?▼

This Skill supports OAuth 2.1 via the Atlassian MCP server with browser-based consent and auto-refreshing tokens, or API token authentication with email and token. Credentials are stored in the system keyring on macOS, Windows, or Linux.

Can I use Jira and Confluence without an API token?▼

Yes, OAuth 2.1 login via python scripts/auth.py login --oauth requires no API token or instance URL. It opens a browser for Atlassian authorization and stores tokens in the keyring with automatic refresh.

Why does my Jira issue transition fail?▼

Transitions fail when the target status is not available in the issue's current workflow state. The script lists available transitions when this happens, so use one of those exact status names.