# Linear — Pipedream Connect

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

- API slug: `linear` (use in MCP headers and tool keys)
- Auth: OAuth (Pipedream-managed)
- Categories: Productivity
- Website: https://linear.app/
- Managed OAuth scopes: `read` · `write` · `issues:create` · `comments:create`
- This page (HTML): https://pipedream.com/apps/linear
- 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`

```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",
      },
    },
  },
)

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-create-comment",
  arguments: {
    teamId: "Team",
    issueId: "Issue",
  },
})
```

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

## API proxy

For a Linear 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-create-comment",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    linear: { 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-create-comment` — Create Comment (Write)

Create a comment in Linear. See the documentation

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

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

Create an initiative in Linear. See the documentation.

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

### `linear-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 OAuth authentication. See Linear docs for additional info here.

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

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

Create a project in Linear. See the documentation.

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

### `linear-get-current-user` — Get Current User (Read-only)

Retrieve rich context about the authenticated Linear user, including core profile fields, recent timestamps, direct team memberships, and high-level organization settings. Returns the user object, a paginated team list (with names, keys, cycle configs, etc.), associated team memberships, and…

Full schema: https://pipedream.com/apps/linear/actions/get-current-user.md

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

Retrieves a Linear issue by its ID. Returns complete issue details including title, description, state, assignee, team, project, labels, and timestamps. Uses OAuth authentication. See Linear docs for additional info here.

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

### `linear-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 OAuth authentication. See Linear docs for additional info here.

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

### `linear-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/actions/get-view-issues.md

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

List comments in Linear. See the documentation.

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

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

List initiatives in Linear. See the documentation.

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

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

List projects in Linear. See the documentation.

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

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

List views in Linear. See the documentation.

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

### `linear-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. Uses OAuth authentication. See the documentation.

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

### `linear-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/actions/remove-label-from-issue.md

### `linear-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 OAuth authentication. See Linear docs for additional info here.

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

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

Update an initiative in Linear. See the documentation.

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

### `linear-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 OAuth authentication. See Linear docs for additional info here.

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

## Triggers (6)

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

Emit new event 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. Uses OAuth authentication. See Linear docs for additional info here.

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

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

Emit new event 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. Uses OAuth authentication. See Linear docs for additional info here.

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

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

Emit new event 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. Uses OAuth authentication. See Linear docs for additional info here.

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

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

Emit new event 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. Uses OAuth authentication. See Linear docs for additional info here.

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

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

Emit new event 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. Uses OAuth authentication. See Linear docs for additional info here.

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

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

Emit new event when a project is updated in Linear. Returns project details including name, description, status, dates, and team info. Supports filtering by specific teams. Uses OAuth authentication. See Linear docs for additional info here.

Full schema: https://pipedream.com/apps/linear/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