# Linear (API key) — Pipedream Connect

> Linear helps streamline software projects, sprints, tasks, and bug tracking. It's built for high-performance teams.

- API slug: `linear_app` (use in MCP headers and tool keys)
- Auth: API key (Pipedream-managed)
- Categories: Productivity
- Website: https://linear.app/
- This page (HTML): https://pipedream.com/apps/linear-app
- Tools: 17 actions · 6 triggers

## Connect via MCP (recommended)

- Endpoint: `https://remote.mcp.pipedream.net/v3`
- Headers: `Authorization: Bearer <token>` · `x-pd-project-id` · `x-pd-environment` · `x-pd-external-user-id` · `x-pd-app-slug: linear_app`

```ts
import { Client } from "@modelcontextprotocol/sdk/client/index.js"
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
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 accessToken = await pd.rawAccessToken

const transport = new StreamableHTTPClientTransport(
  new URL("https://remote.mcp.pipedream.net/v3"),
  {
    requestInit: {
      headers: {
        Authorization: `Bearer ${accessToken}`,
        "x-pd-project-id": process.env.PIPEDREAM_PROJECT_ID!,
        "x-pd-environment": "production",
        "x-pd-external-user-id": "{external_user_id}", // any stable ID for this user in your system
        "x-pd-app-slug": "linear_app",
      },
    },
  },
)

const mcp = new Client({ name: "my-agent", version: "1.0.0" })
await mcp.connect(transport)

const { tools } = await mcp.listTools()

// e.g. run Create Comment:
const result = await mcp.callTool({
  name: "linear_app-create-comment",
  arguments: {
    teamId: "Team",
    issueId: "Issue",
  },
})
```

Docs: [MCP guide](https://pipedream.com/docs/connect/mcp/developers.md)

## API proxy

For a Linear (API key) endpoint with no pre-built tool, the proxy forwards your request with the connected user's credentials attached.

```bash
# The path segment is the target URL, URL-safe base64 encoded:
# https://api.linear.app/graphql

curl "https://api.pipedream.com/v1/connect/{project_id}/proxy/aHR0cHM6Ly9hcGkubGluZWFyLmFwcC9ncmFwaHFs?external_user_id={external_user_id}&account_id=apn_xxxxxxx" \
  -H "Authorization: Bearer {access_token}" \
  -H "x-pd-environment: production"
```

Docs: [API proxy guide](https://pipedream.com/docs/connect/api-proxy.md)

## SDK

```ts
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-create-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear_app: { authProvisionId: "apn_xxxxxxx" },
    teamId: "Team",
    issueId: "Issue",
  },
})
```

Docs: [Managed auth guide](https://pipedream.com/docs/connect/managed-auth/quickstart.md) · [Tools guide](https://pipedream.com/docs/connect/components.md)

## Actions (17)

### `linear_app-create-comment` — Create Comment (Write)

Create a comment in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/create-comment.md

### `linear_app-create-initiative` — Create Initiative (Write)

Create an initiative in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/create-initiative.md

### `linear_app-create-issue` — Create Issue (Write)

Creates a new issue in Linear. Requires team ID and title. Optional: description, assignee, project, state. Returns response object with success status and issue details. Uses API Key authentication. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/create-issue.md

### `linear_app-create-project` — Create Project (Write)

Create a project in Linear. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/create-project.md

### `linear_app-get-issue` — Get Issue (Read-only)

Retrieves a Linear issue by its ID or identifier. Returns complete issue details including title, description, state, assignee, team, project, labels, and timestamps. Uses API Key authentication. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/get-issue.md

### `linear_app-get-teams` — Get Teams (Read-only)

Retrieves all teams in your Linear workspace. Returns array of team objects with details like ID, name, and key. Supports pagination with configurable limit. Uses API Key authentication. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/actions/get-teams.md

### `linear_app-get-view-issues` — Get View Issues (Read-only)

Get issues from a custom view in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/get-view-issues.md

### `linear_app-list-comments` — List Comments (Read-only)

List comments in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/list-comments.md

### `linear_app-list-initiatives` — List Initiatives (Read-only)

List initiatives in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/list-initiatives.md

### `linear_app-list-labels` — List Labels (Read-only)

List issue labels in Linear. Use this to retrieve label IDs and names for filtering or label-management flows. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/list-labels.md

### `linear_app-list-projects` — List Projects (Read-only)

List projects in Linear. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/list-projects.md

### `linear_app-list-views` — List Views (Read-only)

List views in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/list-views.md

### `linear_app-list-workflow-states` — List Workflow States (Read-only)

List workflow states (statuses) in Linear. Returns state IDs, names, types (e.g. backlog, started, completed, cancelled), and team info. Optionally filter by team (use the Get Teams action to discover valid team IDs, e.g. 4e80f53c-da9e-4dee-b14e-2cab3e2e8716). See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/list-workflow-states.md

### `linear_app-remove-label-from-issue` — Remove Label from Issue (Write)

Remove a label from an issue in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/remove-label-from-issue.md

### `linear_app-search-issues` — Search Issues (Read-only)

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.

Full schema: https://pipedream.com/apps/linear-app/actions/search-issues.md

### `linear_app-update-initiative` — Update Initiative (Write)

Update an initiative in Linear. See the documentation

Full schema: https://pipedream.com/apps/linear-app/actions/update-initiative.md

### `linear_app-update-issue` — Update Issue (Write)

Updates an existing Linear issue. Can modify title, description, assignee, state, project, team, labels, priority, and dates. Returns updated issue details. Uses API Key authentication. See the documentation.

Full schema: https://pipedream.com/apps/linear-app/actions/update-issue.md

## Triggers (6)

### `linear_app-new-issue-status-updated` — Issue Status Updated (Instant) (Instant)

Triggers instantly when an issue's workflow state changes (e.g., Todo to In Progress). Returns issue with previous and current state info. Can filter by specific target state. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/new-issue-status-updated.md

### `linear_app-issue-updated-instant` — Issue Updated (Instant) (Instant)

Triggers instantly when any issue is updated in Linear. Provides complete issue details with changes. Supports filtering by team and project. Includes all updates except status changes. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/issue-updated-instant.md

### `linear_app-comment-created-instant` — New Comment Created (Instant) (Instant)

Triggers instantly when a new comment is added to an issue in Linear. Returns comment details including content, author, issue reference, and timestamps. Supports filtering by team. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/comment-created-instant.md

### `linear_app-issue-created-instant` — New Issue Created (Instant) (Instant)

Triggers instantly when a new issue is created in Linear. Provides complete issue details including title, description, team, assignee, state, and timestamps. Supports filtering by team and project. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/issue-created-instant.md

### `linear_app-new-projectupdate-created` — New Project Update Written (Instant) (Instant)

Triggers instantly when a project update (status report) is created in Linear. Returns update content, author, project details, and health status. Filters by team and optionally by project. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/new-projectupdate-created.md

### `linear_app-project-updated-instant` — Project Updated (Instant) (Instant)

Triggers instantly when a project is updated in Linear. Returns project details including name, description, status, dates, and team info. Supports filtering by specific teams. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear-app/triggers/project-updated-instant.md

---

- All apps: https://pipedream.com/apps — index: https://pipedream.com/llms.txt
- Pipedream docs for agents: https://pipedream.com/docs/llms.txt