What can you do with it?

The Jira integration enables comprehensive project management and issue tracking including creating issues, updating issue details, searching with JQL queries, managing assignments, and retrieving project information. You can create bugs, tasks, and stories with structured descriptions, update issue fields, search across projects using Jira’s powerful JQL language, and assign issues to team members. This integration is perfect for development teams and project managers who need to automate their issue tracking workflows.

How to use it?

Basic Command Structure

/your-jira-connection [action] [required-parameters] [optional-parameters]

Parameters

Required:

  • action - The operation you want to perform (create_issue, update_issue, get_issue, search_issues, get_projects, assign_issue)

Optional:

  • project_key - Project identifier for issue operations
  • issue_id - Issue ID or key for specific issue operations
  • jql_query - JQL query string for advanced searching

Tools

Create Issue

Create a new issue in a project

Parameters:

  • action (required) - Set to “create_issue”
  • project_key (required) - Project key (e.g., “PROJ”)
  • summary (required) - Issue title
  • description (required) - Issue description
  • issue_type (required) - Type of issue (Bug, Task, Story, etc.)
  • priority_id (optional) - Priority ID (1=Highest, 2=High, 3=Medium, 4=Low, 5=Lowest)

Example:

/your-jira-connection
action: create_issue
project_key: PROJ
summary: Bug in checkout flow
description: Steps to reproduce: 1. Go to checkout 2. Select payment method 3. Click Submit
issue_type: Bug
priority_id: 2

Response:

{
  "id": "[Created issue ID]",
  "key": "[Issue key like PROJ-123]",
  "self": "[API URL for the issue]"
}

Update Issue

Update an existing issue’s fields

Parameters:

  • action (required) - Set to “update_issue”
  • issue_id (required) - Issue ID or key
  • summary (optional) - Updated summary
  • description (optional) - Updated description

Example:

/your-jira-connection
action: update_issue
issue_id: PROJ-123
summary: Updated summary for bug in checkout flow
description: Updated description with new steps and logs

Response:

{
  "status": "204",
  "message": "Issue updated successfully"
}

Get Issue

Retrieve details of a specific issue

Parameters:

  • action (required) - Set to “get_issue”
  • issue_id (required) - Issue ID or key

Example:

/your-jira-connection
action: get_issue
issue_id: PROJ-123

Response:

{
  "id": "[Issue ID]",
  "key": "[Issue key]",
  "fields": {
    "summary": "[Issue summary]",
    "description": "[Issue description]",
    "status": "[Current status]",
    "priority": "[Priority level]",
    "project": "[Project information]"
  }
}

Search Issues

Search for issues using JQL query

Parameters:

  • action (required) - Set to “search_issues”
  • jql_query (required) - JQL search query
  • start_at (optional) - Starting index for pagination (default: 0)
  • max_results (optional) - Maximum results to return (default: 50)
  • fields (optional) - Specific fields to return

Example:

/your-jira-connection
action: search_issues
jql_query: project = PROJ AND priority = High AND created >= -7d
start_at: 0
max_results: 10
fields: summary, status, priority

Response:

{
  "startAt": "[Starting index]",
  "maxResults": "[Max results]",
  "total": "[Total matching issues]",
  "issues": "[Array of matching issues with requested fields]"
}

Get Projects

Retrieve all accessible projects

Parameters:

  • action (required) - Set to “get_projects”

Example:

/your-jira-connection
action: get_projects

Response:

{
  "projects": "[Array of project objects with id, key, name, and project type]"
}

Assign Issue

Assign an issue to a user by email address

Parameters:

  • action (required) - Set to “assign_issue”
  • issue_id (required) - Issue ID or key
  • assignee_email (required) - Email address of the assignee

Example:

/your-jira-connection
action: assign_issue
issue_id: PROJ-123
assignee_email: user@example.com

Response:

{
  "status": "204",
  "message": "Issue assigned successfully"
}

Notes

Jira uses structured document format for descriptions with type “doc” and nested content arrays. Issue types include Bug, Task, Story, Epic, and custom types defined in your instance. Priority IDs are numeric: 1=Highest, 2=High, 3=Medium, 4=Low, 5=Lowest. JQL (Jira Query Language) supports complex searches with operators like AND, OR, and functions like currentUser(). Assignment requires a two-step process: first finding the user’s account ID by email, then assigning using the account ID. All timestamps use ISO 8601 format.