jira_search
Search Jira work items using JQL queries to find issues by project, status, assignee, priority, or date ranges. Returns matching items with key details for tracking and management.
Instructions
Search for Jira work items using JQL (Jira Query Language). Use to find issues by project, status, assignee, priority, created/updated dates, and more. Returns a list of matching work items with their key, summary, status, priority, and assignee. Common search patterns: 1) My work: 'assignee = currentUser()' 2) My active work: 'assignee = currentUser() AND status NOT IN (Done, Closed)' 3) Project issues: 'project = SSAS' 4) High priority: 'priority = High' or 'priority IN (High, Highest)' 5) Recent updates: 'updated >= -7d' (last 7 days) 6) Combine with AND/OR: 'project = SSAS AND status = Open AND assignee = currentUser()' 7) Sort results: add 'ORDER BY updated DESC' or 'ORDER BY priority DESC, created ASC'
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | JQL (Jira Query Language) query string. Structure: field operator value [AND/OR field operator value] [ORDER BY field ASC/DESC]. Common fields: project, status, assignee, priority, created, updated, summary, description, type. Operators: = (equals), != (not equals), IN (list), NOT IN (exclude list), > < >= <= (comparison), ~ (contains text), IS EMPTY, IS NOT EMPTY. Functions: currentUser() (logged in user), now() (current time), startOfDay(), startOfWeek(). Time: Use formats like -7d (7 days ago), -2w (2 weeks), -1M (1 month). IMPORTANT QUOTING RULES: 1) Multi-word values MUST be in double quotes: status = "In Progress" 2) Email addresses MUST be quoted: assignee = "user@example.com" 3) Special characters (@, #, $, etc.) MUST be in quoted strings 4) Use currentUser() function instead of email when possible 5) List values in parentheses: status IN (Open, "In Progress", Blocked) Examples: 'assignee = currentUser() ORDER BY updated DESC' - your work by recent update, 'project = SSAS AND status = Open' - open issues in SSAS project, 'priority = High AND status != Done' - high priority incomplete work, 'assignee = currentUser() AND status NOT IN (Done, Closed)' - your active work, 'updated >= -7d AND project = SSAS' - SSAS project updated in last 7 days, 'status IN ("In Progress", "Work in progress") AND assignee = currentUser()' - in-progress items, 'assignee = "user@example.com" AND priority = High' - specific user's high priority work | |
| results_limit | No | Maximum number of results to return (default: 10, max: 100) |