JI

jira

Open Source DevelopmentProductivity

Atlassian Jira & Confluence API integration for OpenCode - project management, issue tracking, and documentation

jira confluence atlassian project-management issues agile documentation wiki

Quick Install

npm install @openpets/jira
pnpm add @openpets/jira

Required Environment Variables

  • JIRA_BASE_URL

    Your Jira instance URL (e.g., https://yourcompany.atlassian.net)

  • JIRA_EMAIL

    Jira account email

  • JIRA_API_TOKEN

    Jira API token

Available Tools (28)

These tools are available when you install the jira plugin in your AI assistant.

jira-test-connection

Test Jira connection and return user/organization details for ConnectionDetails component

jira-get-boards

List all available Jira boards with optional filtering by type or project

jira-get-board-details

Get comprehensive information about a specific Jira board including all sprints (active, future, closed)

jira-get-board-issues

Get issues from a specific board with filtering options

jira-get-board-sprints

Get all sprints for a specific board including active, future, and closed sprints

jira-get-sprint-details

Get detailed information about a specific sprint including dates and state

jira-get-sprint-issues

Get all issues in a specific sprint with optional JQL filtering

jira-search-issues

Search for issues using JQL (Jira Query Language)

jira-get-issue

Get comprehensive details about a specific issue

jira-create-issue

Create a new Jira issue

jira-update-issue

Update an existing Jira issue including linking to parent epic and changing reporter

jira-transition-issue

Transition an issue to a different status (e.g., move to In Progress or Done)

jira-add-comment

Add a comment to a Jira issue

jira-get-current-user

Get information about the currently authenticated user

jira-search-users

Search for users by username, email, or display name

jira-get-user

Get detailed information about a specific user

jira-get-issue-fields

Get all available fields and their metadata for issues in a project. Use this to discover custom fields like Epic Link.

jira-link-to-epic

Link one or more issues to an epic. This creates a parent-child relationship where the epic is the parent.

jira-get-epic-issues

Get all issues that are linked to a specific epic

jira-get-projects

List all accessible Jira projects

jira-get-project

Get detailed information about a specific project

jira-add-worklog

Add a work log entry to an issue for time tracking

jira-get-worklogs

Get all work log entries for an issue

jira-get-server-info

Get Jira server information and status

confluence-list-spaces

List all accessible Confluence spaces with optional status filter

confluence-get-space-pages

Get all pages in a specific Confluence space

confluence-get-page-content

Get full content and metadata for a specific Confluence page

confluence-search-pages

Search Confluence pages using CQL (Confluence Query Language)

Example Queries

list all my Jira projects
show me all boards in Jira
get my current user info from Jira
list all Confluence spaces

Usage Scenarios

jira project workflow

  1. 1 list all Jira projects
  2. 2 get details for the first project
  3. 3 search for issues in that project
  4. 4 get details for the first issue found

jira board workflow

  1. 1 show me all Jira boards
  2. 2 get details for the first board
  3. 3 get all issues from that board
  4. 4 show me details of the first issue from the board

jira issue management

  1. 1 search for recent Jira issues using JQL: updated >= -7d
  2. 2 get full details of the first issue
  3. 3 show me worklogs for that issue
  4. 4 get the current user information

confluence documentation workflow

  1. 1 list all Confluence spaces
  2. 2 get all pages from the first space
  3. 3 get the full content of the first page
  4. 4 search for pages with type = page in Confluence

confluence search workflow

  1. 1 search Confluence pages using CQL: type = page
  2. 2 list all current Confluence spaces
  3. 3 search for pages with text content using CQL

jira user workflow

  1. 1 get my current Jira user information
  2. 2 search for users in Jira
  3. 3 get Jira server information

Use jira with Your AI Assistant

This open source plugin works with OpenCode-compatible AI assistants including ChatGPT, Claude, Perplexity, and other LLM-powered coding tools. Install the plugin and start using natural language to interact with jira.

Works with ChatGPT Works with Claude Works with Perplexity MCP Compatible