linear_searchIssues
Find and filter project issues by text, team, assignee, project, or status to manage tasks effectively in Linear.
Instructions
Search for issues with various filters
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "linear_searchIssues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Text to search for in issue title or description | |
| teamId | No | Filter issues by team ID | |
| assigneeId | No | Filter issues by assignee ID | |
| projectId | No | Filter issues by project ID | |
| states | No | Filter issues by state name (e.g., 'Todo', 'In Progress', 'Done') | |
| limit | No | Maximum number of issues to return (default: 10) |
Implementation Reference
- The handler function that implements the core logic for the 'linear_searchIssues' tool. It performs argument validation using the type guard and calls the Linear service's searchIssues method.
export function handleSearchIssues(linearService: LinearService) { return async (args: unknown) => { try { console.log("searchIssues args:", JSON.stringify(args, null, 2)); if (!isSearchIssuesArgs(args)) { console.error("Invalid arguments for searchIssues"); throw new Error("Invalid arguments for searchIssues"); } console.log("Arguments validated successfully"); return await linearService.searchIssues(args); } catch (error) { logError("Error searching issues", error); throw error; } }; } - The tool schema definition for 'linear_searchIssues', specifying input parameters (query, filters, limit) and output format (array of issue objects).
export const searchIssuesToolDefinition: MCPToolDefinition = { name: "linear_searchIssues", description: "Search for issues with various filters", input_schema: { type: "object", properties: { query: { type: "string", description: "Text to search for in issue title or description", }, teamId: { type: "string", description: "Filter issues by team ID", }, assigneeId: { type: "string", description: "Filter issues by assignee ID", }, projectId: { type: "string", description: "Filter issues by project ID", }, states: { type: "array", items: { type: "string" }, description: "Filter issues by state name (e.g., 'Todo', 'In Progress', 'Done')", }, limit: { type: "number", description: "Maximum number of issues to return (default: 10)", }, }, required: [], }, output_schema: { type: "array", items: { type: "object", properties: { id: { type: "string" }, identifier: { type: "string" }, title: { type: "string" }, description: { type: "string" }, state: { type: "string" }, priority: { type: "number" }, estimate: { type: "number" }, dueDate: { type: "string" }, team: { type: "object" }, assignee: { type: "object" }, project: { type: "object" }, cycle: { type: "object" }, parent: { type: "object" }, labels: { type: "array", items: { type: "object", properties: { id: { type: "string" }, name: { type: "string" }, color: { type: "string" } } } }, sortOrder: { type: "number" }, createdAt: { type: "string" }, updatedAt: { type: "string" }, url: { type: "string" } } } } }; - src/tools/handlers/index.ts:80-80 (registration)Registration of the 'linear_searchIssues' handler within the registerToolHandlers function, mapping the tool name to the handler factory.
linear_searchIssues: handleSearchIssues(linearService), - src/tools/type-guards.ts:27-89 (helper)Type guard function used by the handler to validate input arguments for 'linear_searchIssues'.
export function isSearchIssuesArgs(args: unknown): args is { query?: string; teamId?: string; assigneeId?: string; projectId?: string; states?: string[]; limit?: number; } { // Check if args is an object if (typeof args !== "object" || args === null) { console.error("searchIssues args is not an object or is null"); return false; } // Check query if ("query" in args && typeof (args as { query: unknown }).query !== "string") { console.error("searchIssues query is not a string"); return false; } // Check teamId if ("teamId" in args && typeof (args as { teamId: unknown }).teamId !== "string") { console.error("searchIssues teamId is not a string"); return false; } // Check assigneeId if ("assigneeId" in args && typeof (args as { assigneeId: unknown }).assigneeId !== "string") { console.error("searchIssues assigneeId is not a string"); return false; } // Check projectId if ("projectId" in args && typeof (args as { projectId: unknown }).projectId !== "string") { console.error("searchIssues projectId is not a string"); return false; } // Check states if ("states" in args) { const states = (args as { states: unknown }).states; if (!Array.isArray(states)) { console.error("searchIssues states is not an array"); return false; } // Check that all elements in the array are strings for (let i = 0; i < states.length; i++) { if (typeof states[i] !== "string") { console.error(`searchIssues states[${i}] is not a string`); return false; } } } // Check limit if ("limit" in args && typeof (args as { limit: unknown }).limit !== "number") { console.error("searchIssues limit is not a number"); return false; } return true; } - src/tools/definitions/index.ts:73-75 (registration)Inclusion of the searchIssuesToolDefinition in the allToolDefinitions array for overall tool registration.
getIssuesToolDefinition, getIssueByIdToolDefinition, searchIssuesToolDefinition,