jira-auth

Authenticate with Jira Cloud REST API using API tokens or OAuth 2.0.

10|1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/01000001-01001110/agent-jira-skills --skill jira-auth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: jira-auth
Source: https://github.com/01000001-01001110/agent-jira-skills/tree/main/jira-auth
Command: npx skills add https://github.com/01000001-01001110/agent-jira-skills --skill jira-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill streamlines authentication to the Jira Cloud REST API by supporting API tokens and OAuth 2.0, simplifying connection setup, credential validation, and handling rate limits.

Core Features & Use Cases

  • Credential validation: Verify that provided credentials are valid and can access the Jira Cloud instance.
  • Auth header construction: Build proper Authorization headers for REST API calls, ensuring secure communication.
  • Rate-limit awareness: Detect rate limiting and provide guidance for backoff or retries.

Quick Start

Configure environment variables in .claude/skills/jira/.env with JIRA_EMAIL, JIRA_API_TOKEN, and JIRA_BASE_URL, then run: node scripts/run.js test

Frequently Asked Questions about jira-auth

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

FAQPage Schema
How do I authenticate with Jira Cloud REST API using credentials?

Jira Cloud REST API authentication uses either API tokens or OAuth 2.0. Set JIRA_EMAIL, JIRA_API_TOKEN, and JIRA_BASE_URL in your environment, then construct Authorization headers with your credentials for secure API calls.

What's the best way to validate Jira API credentials before making requests?

Validate credentials by testing connectivity to your Jira Cloud instance with a simple REST API call. This confirms your email, API token, and base URL are correct and your account has proper access permissions.

How do I handle rate limits when calling the Jira REST API?

Rate-limit awareness detects when Jira throttles requests and provides guidance for implementing backoff or retry logic. Monitor response headers and adjust request frequency to stay within Jira Cloud's rate-limit thresholds.

Can I use OAuth 2.0 for Jira Cloud authentication instead of API tokens?

Yes, Jira Cloud REST API supports both API tokens and OAuth 2.0 authentication methods. Choose OAuth 2.0 for delegated access scenarios where you need user-level permissions without storing tokens directly.

Do I need to set up environment variables to connect to Jira Cloud?

Yes, configure environment variables in `.claude/skills/jira/.env` with JIRA_EMAIL, JIRA_API_TOKEN, and JIRA_BASE_URL. This enables environment-driven credential loading and keeps sensitive authentication data secure.

What happens if my Jira API token expires or becomes invalid?

Credential validation will fail and flag the authentication error. Regenerate a new API token in your Jira Cloud settings, update your environment variables, and re-test connectivity to restore API access.