Atlassian MCP Expert

What it does

When your agent uses it

• Querying or filtering Jira issues with JQL
• Searching, creating or editing Confluence pages with CQL
• Setting up MCP server authentication for Atlassian products

Example prompts

• “Find all open Jira issues assigned to me in the current sprint, sorted by priority.”
• “Search Confluence for pages in the ENG space updated this month.”
• “Set up OAuth authentication for the Atlassian MCP server.”

Requirements

• An Atlassian MCP server, official cloud, open-source or self-hosted
• A Jira or Confluence API token

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

1. 1Select server - Choose official cloud, open-source, or self-hosted MCP server
2. 2Authenticate - Configure OAuth 2.1, API tokens, or PAT credentials
3. 3Design queries - Write JQL for Jira, CQL for Confluence; validate with maxResults=1 before full execution
4. 4Implement workflow - Build tool calls, handle pagination, error recovery
5. 5Verify permissions - Confirm required scopes with a read-only probe before any write or bulk operation
6. 6Deploy - Configure IDE integration, test permissions, monitor rate limits

What it can do on your machine

Read from SKILL.md and the folder at commit 1be15d8. 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

  No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

  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):

  • github.com
  • synergetic.solutions
  • jeffallan.github.io

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names these keys or tokens, usually read from environment variables:

  • JIRA_API_TOKEN
  • CONFLUENCE_API_TOKEN

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Atlassian MCP Expert loads about 1.3k tokens when it runs, and up to ~17k if it reads all its reference files. Until then it costs about 98 tokens; SKILL.md has 386 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~98

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~17k

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from Jeffallan/claude-skills at commit 1be15d8, republished under its MIT licence (© Jeffallan). 386 words, ~1,331 tokens.

name

atlassian-mcp

description

Integrates with Atlassian products to manage project tracking and documentation via MCP protocol. Use when querying Jira issues with JQL filters, creating and updating tickets with custom fields, searching or editing Confluence pages with CQL, managing sprints and backlogs, setting up MCP server authentication, syncing documentation, or debugging Atlassian API integrations.

license

MIT

metadata.author

https://github.com/Jeffallan

metadata.company

https://synergetic.solutions

metadata.version

1.1.0

metadata.domain

platform

metadata.triggers

Jira, Confluence, Atlassian, MCP, tickets, issues, wiki, JQL, CQL, sprint, backlog, project management

metadata.role

expert

metadata.scope

implementation

metadata.output-format

code

metadata.related-skills

mcp-developer, api-designer, security-reviewer

# Open issues assigned to current user in a sprint
project = PROJ AND status = "In Progress" AND assignee = currentUser() ORDER BY priority DESC

# Unresolved bugs created in the last 7 days
project = PROJ AND issuetype = Bug AND status != Done AND created >= -7d ORDER BY created DESC

# Validate before bulk: test with maxResults=1 first
project = PROJ AND sprint in openSprints() AND status = Open ORDER BY created DESC

# Find pages updated in a specific space recently
space = "ENG" AND type = page AND lastModified >= "2024-01-01" ORDER BY lastModified DESC

# Search page text for a keyword
space = "ENG" AND type = page AND text ~ "deployment runbook"

{
  "mcpServers": {
    "atlassian": {
      "command": "npx",
      "args": ["-y", "@sooperset/mcp-atlassian"],
      "env": {
        "JIRA_URL": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "user@example.com",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}",
        "CONFLUENCE_URL": "https://your-domain.atlassian.net/wiki",
        "CONFLUENCE_EMAIL": "user@example.com",
        "CONFLUENCE_API_TOKEN": "${CONFLUENCE_API_TOKEN}"
      }
    }
  }
}

© Jeffallan, MIT. 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 5 other files (references) in skills/atlassian-mcp of Jeffallan/claude-skills.

• SKILL.md
• references/authentication-patterns.md
• references/common-workflows.md
• references/confluence-operations.md
• references/jira-queries.md
• references/mcp-server-setup.md

Open the folder on GitHubat commit 1be15d8