Linear MCP Server

search_issues

Search for Linear issues using a query string and advanced filters. Supports filtering by assignee, creator, and project. Examples: 1. Find your assigned issues: {query: "", filter: {assignedTo: "me"}}, 2. Find issues you created: {query: "", filter: {createdBy: "me"}}, 3. Find issues assigned to specific user: {query: "", filter: {assignedTo: "user-id-123"}}, 4. Find issues in a specific project: {query: "bug", projectId: "project-123"}, 5. Find issues by project name: {query: "feature", projectName: "Website Redesign"}

Input Schema

NameRequiredDescriptionDefault
filterNoOptional filters to narrow down search results
includeRelationshipsNoInclude additional metadata like team and labels in search results
projectIdNoFilter issues by project ID. Takes precedence over projectName if both are provided.
projectNameNoFilter issues by project name. Will be used to find matching projects if projectId is not provided.
queryYesText to search in issue titles and descriptions. Can be empty string if only using filters.

Input Schema (JSON Schema)

{ "properties": { "filter": { "description": "Optional filters to narrow down search results", "properties": { "assignedTo": { "description": "Filter by assignee. Use \"me\" to find issues assigned to the current user, or a specific user ID.", "type": "string" }, "createdBy": { "description": "Filter by creator. Use \"me\" to find issues created by the current user, or a specific user ID.", "type": "string" } }, "type": "object" }, "includeRelationships": { "default": false, "description": "Include additional metadata like team and labels in search results", "type": "boolean" }, "projectId": { "description": "Filter issues by project ID. Takes precedence over projectName if both are provided.", "type": "string" }, "projectName": { "description": "Filter issues by project name. Will be used to find matching projects if projectId is not provided.", "type": "string" }, "query": { "description": "Text to search in issue titles and descriptions. Can be empty string if only using filters.", "type": "string" } }, "required": [ "query" ], "type": "object" }