---
name: tracker/linear-official:issue-search
description: Search Linear issues with filters
version: "0.5.0"
---

> **Backend:** linear-official (linear@claude-plugins-official)
> **Note:** Requires `linear@claude-plugins-official` plugin. Install: `/plugin install linear@claude-plugins-official`
> **Tool names are provisional.** Exact MCP tool names will be confirmed when the Linear plugin is available. Update this file after enabling the plugin and running tool discovery.

# Linear Issue Search

## Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| query | string | No | Full-text search string |
| team_id | string | No | Limit results to a specific team |
| project_id | string | No | Limit results to a specific project |
| state | string | No | Filter by workflow state name (e.g., "In Progress", "Todo") |
| assignee_id | string | No | Filter by assignee user ID |
| labels | array | No | Array of label names or IDs to filter by |
| limit | integer | No | Maximum number of results to return (default: 25) |

## Implementation

Uses `mcp__linear__searchIssues` (TBD). All filter parameters are optional and combinable. Results are sorted by last-updated date, descending. At least one filter or query is recommended to avoid returning large unscoped result sets.

## Output

| Field | Type | Description |
|-------|------|-------------|
| issues | array | Matching issue objects (id, identifier, title, state, assignee, priority, updated_at) |
| total_count | integer | Total number of issues matching the filters, regardless of limit |

## Errors

| Code | Cause | Recovery |
|------|-------|----------|
| AUTH_FAILED | Plugin is missing, not installed, or lacks read permission | Run `/plugin install linear@claude-plugins-official` and verify plugin auth |
| INVALID_FILTER | A filter value is malformed or references a non-existent resource | Verify filter values and retry |

## Used By

- design-research
- dev-sprint
