aio-atlassian

Atlassian CLI

Jira and Confluence operations via CLI tools from nguyenvanduocit/jira-mcp and nguyenvanduocit/confluence-mcp.

Environment

• Go: !which go 2>/dev/null || echo "NOT INSTALLED"
• jira-cli: !which jira-cli 2>/dev/null || echo "NOT INSTALLED"
• confluence-cli: !which confluence-cli 2>/dev/null || echo "NOT INSTALLED"
• ATLASSIAN_HOST: !echo ${ATLASSIAN_HOST:-NOT SET}
• ATLASSIAN_EMAIL: !echo ${ATLASSIAN_EMAIL:-NOT SET}
• ATLASSIAN_TOKEN: ![ -n "$ATLASSIAN_TOKEN" ] && echo "SET" || echo "NOT SET"

Install

go install github.com/nguyenvanduocit/jira-mcp/cmd/jira-cli@latest
go install github.com/nguyenvanduocit/confluence-mcp/cmd/confluence-cli@latest

Or via Homebrew (confluence-cli only):

brew install nguyenvanduocit/tap/confluence-mcp

Credentials (get token from https://id.atlassian.com/manage-profile/security/api-tokens):

Create a .env file:

ATLASSIAN_HOST=https://your-company.atlassian.net
[email protected]
ATLASSIAN_TOKEN=your-api-token

All CLI commands accept --env .env to load credentials from this file.

Global flags: --env <path> (load .env file), --output text|json (output format, default: text)

---

Jira CLI

Issues

# Get issue (full details with transitions, changelog, subtasks, description)
jira-cli get-issue --issue-key PROJ-123 --env .env
jira-cli get-issue --issue-key PROJ-123 --fields summary,status --output json
jira-cli get-issue --issue-key PROJ-123 --expand transitions,changelog

# Search issues with JQL
jira-cli search-issues --jql "project = PROJ AND status = 'In Progress'" --env .env
jira-cli search-issues --jql "assignee = currentUser() AND sprint in openSprints()" --max-results 10 --env .env
jira-cli search-issues --jql "project = PROJ AND created >= -7d" --fields summary,status --env .env

# Create issue
jira-cli create-issue --project PROJ --summary "Bug title" --type Bug --env .env
jira-cli create-issue --project PROJ --summary "New feature" --type Story \
  --description "## Overview\nA new feature" --priority High --env .env
jira-cli create-issue --project PROJ --summary "Task" --type Task \
  --assignee 5a1234b --priority Medium --env .env

# Create child issue (subtask)
jira-cli create-child-issue --parent-key PROJ-100 --summary "Subtask 1" --env .env
jira-cli create-child-issue --parent-key PROJ-100 --summary "Subtask" \
  --description "Details here" --type Subtask --env .env

# Update issue
jira-cli update-issue --issue-key PROJ-123 --summary "Updated title" --env .env
jira-cli update-issue --issue-key PROJ-123 --priority High --assignee 5a1234b --env .env
jira-cli update-issue --issue-key PROJ-123 --description "## New description" --env .env

# Delete issue (cannot be undone)
jira-cli delete-issue --issue-key PROJ-123 --env .env

# List available issue types
jira-cli list-issue-types --env .env