openclaw-skill-atlassian-jira

OpenClaw skill for Atlassian Jira Cloud — CRUD issues, comments, attachments, workflow transitions, and JQL search via Jira REST API v3.

By Abdelkrim BOUJRAF / ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

Table of Contents

• Features
• Quick Start
• Setup
• Commands
• Security
• ClawHub
• License
• Author
• Contributing

Features

• Issues — Create, read, update, delete, list, and search (JQL)
• Comments — Add, update, delete, and list
• Attachments — Upload, list, and delete
• Workflow Transitions — List available transitions and move issues through workflow states
• Security — --confirm required for deletes, no secrets to stdout, rate-limit retry with backoff
• Auth — Email + API token (Basic auth)

Quick Start

# 1. Clone
git clone https://github.com/ALT-F1-OpenClaw/openclaw-skill-atlassian-jira.git
cd openclaw-skill-atlassian-jira

# 2. Install
npm install

# 3. Configure
cp .env.example .env
# Edit .env with your Jira Cloud credentials

# 4. Use
node scripts/jira.mjs list --project PROJ
node scripts/jira.mjs create --project PROJ --summary "My first issue"
node scripts/jira.mjs read --key PROJ-1

Setup

1. Go to https://id.atlassian.com/manage-profile/security/api-tokens
2. Create an API token
3. Copy .env.example to .env and fill in:
   • JIRA_HOST — your Jira Cloud instance (e.g. yourcompany.atlassian.net)
   • JIRA_EMAIL — your Atlassian account email
   • JIRA_API_TOKEN — the API token you just created
   • JIRA_DEFAULT_PROJECT — (optional) default project key

Commands

See SKILL.md for full command reference.

Security

• Email + API token auth (Basic auth via base64 encoding)
• No secrets or tokens printed to stdout
• All delete operations require explicit --confirm flag
• Built-in rate limiting with exponential backoff retry
• Lazy config validation (only checked when a command runs)

ClawHub

Published as: atlassian-jira-by-altf1be

clawhub install atlassian-jira-by-altf1be

License

MIT — see LICENSE

Author

Abdelkrim BOUJRAF — ALT-F1 SRL, Brussels 🇧🇪 🇲🇦

• GitHub: @abdelkrim
• X: @altf1be

Contributing

Contributions welcome! Please open an issue or PR.