search_issues

Search Linear issues by query, assignee, creator, or project. Use filters to find issues assigned to you, created by you, or within specific projects for targeted issue tracking.

Instructions

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

Name	Required	Description
`filter`	No	Optional filters to narrow down search results
`includeRelationships`	No	Include additional metadata like team and labels in search results
`projectId`	No	Filter issues by project ID. Takes precedence over projectName if both are provided.
`projectName`	No	Filter issues by project name. Will be used to find matching projects if projectId is not provided.
`query`	Yes	Text 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"
}

Linear MCP Server

search_issues

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Linear MCP Server

Related Tools