Claude Jira Skill

claude-jira-skill

A Claude Code skill that interacts with Jira Cloud via the REST API v3 directly — no MCP server, no CLI binary, just `curl`. Claude reads the skill and executes API calls inline via the Bash tool.

Why not MCP?

The official Atlassian MCP server loads tool descriptions into every session and is unreliable in practice. This skill is a single markdown file Claude loads on demand when you mention a Jira ticket. No persistent process, no silent failures.

Prerequisites

• Claude Code ≥ 2.0
• curl and jq (both available by default on macOS; brew install jq if missing)
• A Jira Cloud account with API token access

Install

git clone https://github.com/stevenluongo/claude-jira-skill.git
cd claude-jira-skill
chmod +x setup.sh
./setup.sh

The setup script will ask for your Jira domain, project key, email, API token, and where to install.

API token

Sign in to your Jira site first — otherwise the token URL bounces through a login and lands on your profile page instead of the token list.

1. Sign in at https://.atlassian.net
2. Go to id.atlassian.com/manage-profile/security/api-tokens — or navigate by hand: avatar (top right) → Manage account → Security → Create and manage API tokens
3. Click Create API token
4. Enter a label (e.g. claude-code-cli)
5. Set an expiration date (1–365 days)
6. Click Create and copy the token immediately — Atlassian won't show it again

No scopes need to be selected. Classic API tokens inherit your Atlassian account's existing Jira permissions.

Supported operations

#	Operation	API endpoint
1	Get ticket	GET /rest/api/3/issue/{key}
2	Search / JQL	POST /rest/api/3/search/jql
3	Create ticket	POST /rest/api/3/issue
4	Transition status	POST /rest/api/3/issue/{key}/transitions
5	Add comment