Atlassian MCP Expert
Jeffallan/claude-skills
Queries and edits Jira issues and Confluence pages through an MCP server, covering JQL and CQL queries, server setup, authentication and sprint or backlog workflows.
Manage Jira issues and Confluence wiki pages in Atlassian Cloud.
Install Atlassian
$ npx skills add sanjay3290/ai-skills --skill atlassian -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install sanjay3290/ai-skills atlassian --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/atlassian .claude/skills/atlassian && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .claude/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassianType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add sanjay3290/ai-skills --skill atlassian -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install sanjay3290/ai-skills atlassian --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/atlassian .agents/skills/atlassian && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .agents/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sanjay3290/ai-skills --skill atlassian -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install sanjay3290/ai-skills atlassian --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/atlassian .cursor/skills/atlassian && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .cursor/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/sanjay3290/ai-skills.git --path skills/atlassian--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add sanjay3290/ai-skills --skill atlassian -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install sanjay3290/ai-skills atlassian --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/atlassian .gemini/skills/atlassian && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .gemini/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install sanjay3290/ai-skills atlassianInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add sanjay3290/ai-skills --skill atlassian -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/atlassian .github/skills/atlassian && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .github/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add sanjay3290/ai-skills --skill atlassian -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install sanjay3290/ai-skills atlassian --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/atlassian .opencode/skills/atlassian && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "atlassian" agent skill from https://github.com/sanjay3290/ai-skills/tree/main/skills/atlassian into .opencode/skills/atlassian/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "atlassian", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
atlassian- GitHub stars
- 431
- Token cost
- ~1.6k tokens
- SKILL.md length
- 406 words
- Files
- 8 (incl. scripts)
- Skills in repo
- 24
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
Manage Jira issues and Confluence wiki pages in Atlassian Cloud.
- Searching/creating/updating Jira issues with JQL
- SKILL.md covers First-Time Setup, Backend Selection, Jira (scripts/jira.py) and Confluence…, plus 2 more sections
- Runs Python scripts from its folder; calls python and pip
- Searching/reading/creating Confluence pages with CQL
What it does
Atlassian is an agent skill from sanjay3290/ai-skills. Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Use when: (1) searching/creating/updating Jira issues with JQL, (2) searching/reading/creating Confluence pages with CQL, (3) managing Jira workflows, transitions, and comments, (4) browsing Confluence spaces and page hierarchies. Supports OAuth 2.1 via MCP server (recommended) or API token authentication (fallback).
Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts (for example `scripts/api_client.py`, `scripts/auth.py` and `scripts/confluence.py`).
It sits in Backend & APIs, covering OAuth and OpenID Connect, MCP servers and Authentication. It works with Confluence, Jira and Model Context Protocol. The repository describes itself as: 24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace. The licence is Apache-2.0.
When your agent uses it
- Searching/creating/updating Jira issues with JQL
- Searching/reading/creating Confluence pages with CQL
- Managing Jira workflows
- Browsing Confluence spaces and page hierarchies
Example prompts
- “/atlassian”
Requirements
- Python 3
What it can do on your machine
Read from SKILL.md and the folder at commit 281d88d. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 5 files in scripts/ (Python), which the agent can run.
Shell commands in SKILL.md call:
pythonpip
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
id.atlassian.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Atlassian loads about 1.6k tokens when it runs. Until then it costs about 98 tokens; SKILL.md has 406 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
SKILL.md
The full file from sanjay3290/ai-skills at commit 281d88d, republished under its Apache-2.0 licence (© sanjay3290). 406 words, ~1,582 tokens.
Download SKILL.mdSave it as
.claude/skills/atlassian/SKILL.md (or your agent's skills folder). This skill also uses 7 other files; get the full folder from GitHub.- name
- atlassian
- description
- Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Use when: (1) searching/creating/updating Jira issues with JQL, (2) searching/reading/creating Confluence pages with CQL, (3) managing Jira workflows, transitions, and comments, (4) browsing Confluence spaces and page hierarchies. Supports OAuth 2.1 via MCP server (recommended) or API token authentication (fallback).
Atlassian (Jira + Confluence)
Full Jira and Confluence integration with two authentication methods:
- OAuth 2.1 via Atlassian MCP server — browser-based consent, auto-refresh tokens, calls MCP tools
- API token — email + token stored in keyring, calls REST API directly
First-Time Setup
Option 1: OAuth 2.1 via MCP Server (Recommended)
No API tokens or instance URLs needed. Uses dynamic client registration and PKCE.
pip install -r requirements.txt
python scripts/auth.py login --oauthA browser opens for Atlassian authorization. Select which products (Jira, Confluence, Compass) to grant access. Tokens are stored in the system keyring and auto-refresh when expired.
Check status:
python scripts/auth.py statusOption 2: API Token (Fallback)
For environments where browser-based OAuth isn't available.
pip install -r requirements.txt
python scripts/auth.py loginFollow the prompts to enter your Atlassian URL, email, and API token. Credentials are stored securely in the system keyring.
Create an API token at: https://id.atlassian.com/manage-profile/security/api-tokens
Check authentication status:
python scripts/auth.py statusLogout (clears both OAuth and API token credentials):
python scripts/auth.py logoutBackend Selection
The scripts automatically detect which backend to use based on your auth type:
- OAuth → MCP backend (calls Atlassian MCP server tools)
- API token → REST backend (calls Atlassian REST API directly)
All commands work identically regardless of backend.
Jira (scripts/jira.py)
Search issues with JQL
python scripts/jira.py search "project = DEV AND status = Open"
python scripts/jira.py search "assignee = currentUser() ORDER BY updated DESC" --limit 10Get issue details
python scripts/jira.py get DEV-123Create an issue
python scripts/jira.py create --project DEV --summary "Fix login bug" --type Bug
python scripts/jira.py create --project DEV --summary "New feature" --type Story \
--description "Details here" --priority High --assignee "user@example.com" --labels "backend,urgent"Update an issue
python scripts/jira.py update DEV-123 --summary "Updated summary" --priority High
python scripts/jira.py update DEV-123 --assignee "user@example.com"Transition issue status
python scripts/jira.py transition DEV-123 "In Progress"
python scripts/jira.py transition DEV-123 "Done"Add and list comments
python scripts/jira.py comment DEV-123 --add "This is a comment"
python scripts/jira.py comment DEV-123 --listList projects and statuses
python scripts/jira.py list-projects
python scripts/jira.py list-statuses DEVTest authentication
python scripts/jira.py auth-infoList available MCP tools (OAuth only)
python scripts/jira.py list-toolsConfluence (scripts/confluence.py)
Search pages
python scripts/confluence.py search "deployment guide"
python scripts/confluence.py search "type=page AND space=DEV AND text~\"deployment\""
python scripts/confluence.py search "onboarding" --limit 10Read a page
python scripts/confluence.py read <page-id>
python scripts/confluence.py read <page-id> --jsonList spaces
python scripts/confluence.py list-spaces
python scripts/confluence.py list-spaces --limit 50Get space details
python scripts/confluence.py get-space <space-id>List pages in a space
python scripts/confluence.py list-pages --space-id <space-id>Create a page
python scripts/confluence.py create --title "New Page" --space-id <space-id>
python scripts/confluence.py create --title "Guide" --space-id <id> --body "<p>Content here</p>"
python scripts/confluence.py create --title "Child" --space-id <id> --parent-id <parent-id>Update a page
python scripts/confluence.py update <page-id> --title "Updated Title"
python scripts/confluence.py update <page-id> --body "<p>New content</p>"Get child pages
python scripts/confluence.py get-children <page-id>Test authentication
python scripts/confluence.py auth-infoList available MCP tools (OAuth only)
python scripts/confluence.py list-toolsShow full SKILL.md (163 more words)Show less
Operations Reference
Jira
| Command | Description | Required Args |
|---|---|---|
| search | Search issues with JQL | jql |
| get | Get issue details | issue_key |
| create | Create new issue | --project, --summary, --type |
| update | Update existing issue | issue_key |
| transition | Change issue status | issue_key, status |
| comment | Add or list comments | issue_key |
| list-projects | List accessible projects | - |
| list-statuses | List statuses for project | project_key |
| auth-info | Test API connection | - |
| list-tools | List MCP tools (OAuth only) | - |
Confluence
| Command | Description | Required Args |
|---|---|---|
| search | Search using CQL | query |
| read | Get page content | page_id |
| list-spaces | List all spaces | - |
| get-space | Get space details | space_id |
| list-pages | List pages in a space | --space-id |
| create | Create new page | --title, --space-id |
| update | Update existing page | page_id |
| get-children | Get child pages | page_id |
| auth-info | Test API connection | - |
| list-tools | List MCP tools (OAuth only) | - |
JSON Output
Add --json flag to any script command for machine-readable output.
Token Management
Credentials stored securely using the system keyring:
- macOS: Keychain
- Windows: Windows Credential Locker
- Linux: Secret Service API
Service name: atlassian-skill
OAuth tokens auto-refresh when expired (if refresh token is available).
© sanjay3290, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
SKILL.md and 7 other files (scripts) in skills/atlassian of sanjay3290/ai-skills.
- SKILL.md
- .env.example
- requirements.txt
- scripts/api_client.py
- scripts/auth.py
- scripts/confluence.py
- scripts/jira.py
- scripts/mcp_client.py
Open the folder on GitHubat commit 281d88d
Compare with similar skills
Atlassian next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Atlassian this skillsanjay3290/ai-skills | 431 | — | ~1.6k | Automated safety check: Pass | Apache-2.0 | |
| Atlassian MCP ExpertJeffallan/claude-skills | 12k | — | ~1.3k | Automated safety check: Pass | MIT | |
| Spring Security ConfigurationAmplicode/spring-skills | 126 | — | ~4.3k | Automated safety check: Pass | None | |
| API Authcyanheads/pubmed-mcp-server | 156 | — | ~2.7k | Automated safety check: Pass | Apache-2.0 | |
| Markdown To Confluencetestdouble/han | 279 | — | ~2.4k | Automated safety check: Pass | MIT | |
| MCP Atlassiansundial-org/awesome-openclaw-skills | 663 | — | ~433 | Automated safety check: Pass | None |
Similar skills
Spring Security Configuration
Amplicode/spring-skills
Creates a Spring Security configuration class with authentication, authorization, and HTTP protection setup.
API Auth
cyanheads/pubmed-mcp-server
Authentication, authorization, and multi-tenancy patterns for @cyanheads/mcp-ts-core.
Markdown To Confluence
testdouble/han
Publishes a local Markdown file to a user-specified Confluence location, creating a new page or updating an existing one through the Atlassian MCP server.
MCP Atlassian
sundial-org/awesome-openclaw-skills
Run the Model Context Protocol (MCP) Atlassian server in Docker, enabling integration with Jira, Confluence, and other Atlassian products.
Xquik MCP
Xquik-dev/x-twitter-scraper
Connect, verify, and troubleshoot Xquik's remote MCP server.
More from sanjay3290/ai-skills
All 24 skills in this repoDeep Research
sanjay3290/ai-skills
Execute autonomous multi-step research using Google Gemini Deep Research Agent.
Imagen
sanjay3290/ai-skills
Generate images using Google Gemini's image generation capabilities.
Notebooklm
sanjay3290/ai-skills
Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports.
Whatsapp
sanjay3290/ai-skills
Send and receive WhatsApp messages via the unofficial linked-device client pywhats (pip install pywhats) — pair with QR, send text/images, group chat, read receipts, presence/typing, and a…
Postgres
sanjay3290/ai-skills
Execute read-only SQL queries against multiple PostgreSQL databases.
Azure Devops
sanjay3290/ai-skills
Manage Azure DevOps projects, work items, repos, PRs, pipelines, wikis, test plans, security alerts, variable groups, environments/approvals, branch policies, and attachments.
Related
Works with
Categories
Questions about Atlassian
What does Atlassian do?
Manage Jira issues and Confluence wiki pages in Atlassian Cloud. Atlassian is an agent skill from sanjay3290/ai-skills. Manage Jira issues and Confluence wiki pages in Atlassian Cloud.
When should I use Atlassian?
Atlassian fits situations like: searching/creating/updating Jira issues with JQL; searching/reading/creating Confluence pages with CQL; managing Jira workflows; browsing Confluence spaces and page hierarchies.
How do I install Atlassian in Claude Code?
Run `npx skills add sanjay3290/ai-skills --skill atlassian -a claude-code`. Or copy the skill folder (skills/atlassian in sanjay3290/ai-skills) into .claude/skills/atlassian in your project. Claude Code loads it when a task matches its description.
How do I install Atlassian in Codex?
Run `npx skills add sanjay3290/ai-skills --skill atlassian -a codex`. Or copy the skill folder (skills/atlassian in sanjay3290/ai-skills) into .agents/skills/atlassian in your project. Codex loads it when a task matches its description.
Can I use Atlassian in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sanjay3290/ai-skills --skill atlassian -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/atlassian, .gemini/skills/atlassian, .github/skills/atlassian and .opencode/skills/atlassian in your project.
What does Atlassian need to run?
Going by SKILL.md and its folder, Atlassian needs Python for the scripts in its folder and the command-line tools its instructions call (python and pip). Our summary lists: Python 3.
Does Atlassian access the network?
SKILL.md names 1 domain. As links in the text: id.atlassian.com. This is read from the text; nothing was executed.
Is Atlassian safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
What licence does Atlassian use?
Atlassian is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Atlassian use?
About 1.6k tokens (SKILL.md is roughly 6.3k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Atlassian?
Skills that share tags, products or a category with Atlassian: Atlassian MCP Expert (Jeffallan/claude-skills, 12k stars), Spring Security Configuration (Amplicode/spring-skills, 126 stars), API Auth (cyanheads/pubmed-mcp-server, 156 stars) and Markdown To Confluence (testdouble/han, 279 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Atlassian?
sanjay3290 (a GitHub user) maintains it in sanjay3290/ai-skills, which has 431 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 10, 2026.
Source: sanjay3290/ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.