Claude
Skills
Sign in
Back

jira

Included with Lifetime
$97 forever

Manage Jira issues, projects, and boards via the Atlassian REST API.

Backend & APIs

What this skill does


# Jira

Manage Jira issues, projects, and boards via the REST API.

## Environment Variables

- `JIRA_BASE_URL` - Jira instance URL (e.g. `https://yourorg.atlassian.net`)
- `JIRA_EMAIL` - Atlassian account email
- `JIRA_API_TOKEN` - API token (generate at https://id.atlassian.com/manage-profile/security/api-tokens)

## Auth header

All requests use Basic auth:

```bash
JIRA_AUTH=$(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)
```

## Search issues (JQL)

```bash
curl -s -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  -H "Content-Type: application/json" \
  "$JIRA_BASE_URL/rest/api/3/search?jql=project%3DDEV%20AND%20status%3D%22In%20Progress%22&maxResults=10" | jq '.issues[] | {key, summary: .fields.summary, status: .fields.status.name}'
```

## Get issue details

```bash
curl -s -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  "$JIRA_BASE_URL/rest/api/3/issue/DEV-123" | jq '{key, summary: .fields.summary, status: .fields.status.name, assignee: .fields.assignee.displayName, description: .fields.description}'
```

## Create issue

```bash
curl -s -X POST -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  -H "Content-Type: application/json" \
  "$JIRA_BASE_URL/rest/api/3/issue" \
  -d '{
    "fields": {
      "project": {"key": "DEV"},
      "summary": "Bug: Login page broken",
      "description": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Description here"}]}]},
      "issuetype": {"name": "Bug"}
    }
  }' | jq '{key: .key, self: .self}'
```

## Transition issue (change status)

```bash
# First get available transitions
curl -s -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  "$JIRA_BASE_URL/rest/api/3/issue/DEV-123/transitions" | jq '.transitions[] | {id, name}'

# Then transition
curl -s -X POST -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  -H "Content-Type: application/json" \
  "$JIRA_BASE_URL/rest/api/3/issue/DEV-123/transitions" \
  -d '{"transition": {"id": "31"}}'
```

## Add comment

```bash
curl -s -X POST -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  -H "Content-Type: application/json" \
  "$JIRA_BASE_URL/rest/api/3/issue/DEV-123/comment" \
  -d '{"body": {"type": "doc", "version": 1, "content": [{"type": "paragraph", "content": [{"type": "text", "text": "Comment from ThinkFleetBot"}]}]}}' | jq '{id: .id, created: .created}'
```

## List projects

```bash
curl -s -H "Authorization: Basic $(echo -n "$JIRA_EMAIL:$JIRA_API_TOKEN" | base64)" \
  "$JIRA_BASE_URL/rest/api/3/project" | jq '.[] | {key, name}'
```

## Notes

- Jira Cloud uses API v3 with ADF (Atlassian Document Format) for descriptions/comments.
- Jira Server/Data Center may use API v2 with plain text or wiki markup.
- Rate limits apply; check response headers for `X-RateLimit-Remaining`.
- Always confirm before creating, transitioning, or deleting issues.

Related in Backend & APIs