> This page is for Agent Handler.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.merge.dev/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.merge.dev/_mcp/server.

# Linear

**Authentication:** OAuth or API key. See [Magic Link](/merge-agent-handler/features/magic-link) for the runtime auth flow, or [Application credentials](/merge-agent-handler/admin-setup/add-oauth-credentials) to bring your own OAuth app.

## Sample use cases

* List every issue in the `Platform` team assigned to me, sorted by priority.
* Create a Linear issue from each row in this triage doc and assign by area.
* Find every issue closed in the last 7 days, grouped by project.

## Available Tools

#### create\_comment

Creates a new comment

#### resolve\_comment

Resolves a comment

#### unresolve\_comment

Unresolves a comment

#### update\_comment

Updates a comment

#### get\_comment

Get a single comment by ID

#### get\_comments

Get comments with filtering and pagination. Filter by issue (supports 'TEAM-123' identifiers), body text, dates. Returns comment details with user and issue info.

#### list\_cycles

Get a list of cycles from Linear. Supports filtering, pagination (first, last, before, after), and returns all fields as per the Linear Cycle schema. Returns nodes and pageInfo

#### get\_issue\_labels

Get a list of IssueLabel objects from Linear

#### create\_issue\_label

Creates a new issue label

#### list\_issue\_statuses

Get a list of issue statuses from Linear (workflow states). Supports filtering and pagination

#### get\_issues

Get a list of issues from Linear with filtering and pagination support.

#### get\_issue

Get a single issue by ID from Linear. Returns all fields as per the Linear Issue schema

#### create\_issue

Create Linear issue with title, description, priority, assignee, labels, estimates, dates, icon, sub-issue order. Supports team, project, cycle, parent, subscribers. Use child labels only.

#### update\_issue

Update Linear issue: title, description, priority, assignee, state, labels, dates, project, cycle, subscribers (add/remove/replace), icon, sub-issue order. Use child labels only.

#### archive\_issue

Archive (delete) an issue in Linear by ID

#### get\_projects

Get a list of projects from Linear.

#### get\_project

Get a single project by ID from Linear. Returns all fields as per the Linear Project schema

#### create\_project

Create a new project in Linear with comprehensive field validation.

#### update\_project

Update an existing project in Linear. Use statusId (not state) to change project status.

#### archive\_project

Archive a project in Linear by ID

#### get\_project\_updates

Get project updates from Linear. Supports optional project\_id targeting, advanced filter usage, pagination, and includeArchived.

#### get\_project\_update

Get a single project update by ID from Linear.

#### create\_project\_update

Create a project update in Linear using body text and optional health/diff visibility.

#### update\_project\_update

Update an existing project update in Linear.

#### archive\_project\_update

Archive a project update in Linear by ID.

#### unarchive\_project\_update

Unarchive a project update in Linear by ID.

#### get\_teams

Get a list of teams from Linear. Supports filtering by name/key and pagination

#### get\_team

Get a team by id from Linear

#### create\_team

Create a team in Linear

#### update\_team

Update a team in Linear

#### get\_users

Get a list of users from Linear. Supports pagination. Linear's API does not support CRUD operations on Users

#### get\_user

Get a single user from Linear by ID