Jira Connector

The Jira connector ingests issues, comments, and status changes into CortexDB as typed episodes.

Setup

CORTEX_JIRA_URL=https://your-org.atlassian.net
[email protected]
CORTEX_JIRA_API_TOKEN=your-jira-api-token
CORTEX_JIRA_PROJECTS=CORTEX,PLATFORM
CORTEX_JIRA_TENANT_ID=my-app

cortexdb-connector jira \
  --url https://your-org.atlassian.net \
  --email [email protected] \
  --token your-jira-api-token \
  --projects "CORTEX,PLATFORM" \
  --tenant-id my-app

What Gets Ingested

| Jira Event | Episode Type | Content | |---|---|---| | Issue created/updated | task | Issue summary and description | | Comment | message | Comment text | | Status change | event | Transition details | | Sprint change | event | Sprint assignment |

Episode Example

{
  "type": "task",
  "content": "Implement tenant-level rate limiting for the REST API. Must support configurable limits per endpoint.",
  "source": "jira",
  "author": "alice",
  "timestamp": "2026-03-15T09:00:00Z",
  "metadata": {
    "ticket_id": "CORTEX-789",
    "status": "in_progress",
    "priority": "high",
    "assignee": "bob",
    "sprint": "Sprint 14",
    "story_points": 5,
    "labels": ["backend", "api"]
  }
}

Configuration

| Variable | Default | Description | |---|---|---| | CORTEX_JIRA_URL | Required | Jira instance URL | | CORTEX_JIRA_EMAIL | Required | Jira user email | | CORTEX_JIRA_API_TOKEN | Required | Jira API token | | CORTEX_JIRA_PROJECTS | Required | Comma-separated project keys | | CORTEX_JIRA_TENANT_ID | Required | Target tenant | | CORTEX_JIRA_NAMESPACE | jira | Target namespace | | CORTEX_JIRA_INCLUDE_SUBTASKS | true | Include sub-tasks | | CORTEX_JIRA_INCLUDE_COMMENTS | true | Include issue comments | | CORTEX_JIRA_BACKFILL_DAYS | 90 | Days of history to backfill | | CORTEX_JIRA_POLL_INTERVAL_SEC | 60 | Polling interval |