View as Markdown
Linear (API key) icon

Linear (API key) ACTION

Search Issues

Searches Linear issues by team, project, assignee, labels, state, or text query. Supports pagination, ordering, and archived issues. Returns array of matching issues. Uses API Key authentication. See Linear docs for additional info here.
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Linear (API key) account once, then configure and run Search Issues from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "linear_app-search-issues",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team",
    projectId: "Project",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Search Issues inputs
Property Type Description
teamId Team string
The team associated with the issue. Select one from the list, or pass the team's id as returned by the Linear API — a UUID such as 9d1c3f7e-2b48-4c6a-9f1e-5a7b8c9d0e1f. The short team key shown in issue identifiers such as ENG-123 is rejected.
Required Dynamic
projectId Project string
The identifier or key of the project associated with the issue
Optional Dynamic
query Query string
Search string to look for in issue titles. The query is used to filter issues where the title contains the query text (case insensitive).
Optional
stateId State (Status) string
Filter issues by their workflow state (status). States are scoped to the selected team.
Optional Dynamic
assigneeId Assignee string
The user to assign to the issue
Optional Dynamic
issueLabels Issue Labels string[]
The labels in the issue
Optional Dynamic
orderBy Order By string
By which field should the pagination order by. Available options are createdAt (default) and updatedAt.
Optional
includeArchived Include archived boolean
Should archived resources be included? (default: false)
Optional
limit Limit integer
Maximum number of issues to return. If no query is provided, this defaults to 20 to avoid returning too many results.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
linear_app-search-issues
Version
0.2.21
App
Linear (API key)
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes