Linear

Productivityby Linear Orbit, Inc

Launched Mar 24, 2026 on ChatGPT

Manage issues, projects, and team workflows in Linear with natural language. Create and update issues, track progress, plan cycles, and coordinate development tasks using Linear’s streamlined project management interface for faster, more efficient workflows.

45ChatGPT Tools

22Claude Tools

Linear Orbit, IncDeveloper

ProductivityCategory

Use Cases

productivity

Available Tools

Create attachment

create_attachment

Full Description

Create a new attachment on a specific Linear issue by uploading base64-encoded content.

Parameters (4 required, 2 optional)

Required

base64Contentstring

Base64-encoded file content to upload

contentTypestring

MIME type for the upload (e.g., 'image/png', 'application/pdf')

filenamestring

Filename for the upload (e.g., 'screenshot.png')

issuestring

Issue ID or identifier (e.g., LIN-123)

Optional

subtitlestring

Optional subtitle for the attachment

titlestring

Optional title for the attachment

Create document

create_document

Full Description

Create a new document in Linear

Parameters (1 required, 5 optional)

Required

titlestring

Document title

Optional

colorstring

Hex color

contentstring

Content as Markdown

iconstring

Icon emoji

issuestring

Issue ID or identifier (e.g., LIN-123)

projectstring

Project name, ID, or slug

Create issue label

create_issue_label

Full Description

Create a new Linear issue label

Parameters (1 required, 5 optional)

Required

namestring

Label name

Optional

colorstring

Hex color code

descriptionstring

Label description

isGroupboolean

Is label group (not directly applicable)

Default: False

parentstring

Parent label group name

teamIdstring

Team UUID (omit for workspace label)

Delete attachment

delete_attachment

Full Description

Delete an attachment by ID

Parameters (1 required)

Required

idstring

Attachment ID

Delete comment

delete_comment

Full Description

Delete a comment from a Linear issue

Parameters (1 required)

Required

idstring

Comment ID

Delete customer

delete_customer

Full Description

Delete a customer in Linear

Parameters (1 required)

Required

idstring

Customer ID

Delete customer need

delete_customer_need

Full Description

Archive a customer need in Linear

Parameters (1 required)

Required

idstring

Customer need ID

Delete status update

delete_status_update

Full Description

Delete (archive) a project or initiative status update.

Parameters (2 required)

Required

idstring

Status update ID

typestring

Type of status update

Options:projectinitiative

Extract images

extract_images

Full Description

Extract and fetch images from markdown content. Use this to view screenshots, diagrams, or other images embedded in Linear issues, comments, or documents. Pass the markdown content (e.g., issue description) and receive the images as viewable data.

Parameters (1 required)

Required

markdownstring

Markdown content containing image references (e.g., issue description, comment body)

Fetch

fetch

Full Description

Fetch a Linear issue, project, initiative, or document by entity-prefixed ID. Use to get full details for results returned by the search tool. Also works with any known identifier.

Parameters (1 required)

Required

idstring

Entity-prefixed ID returned by `search`, like `issue:LIN-123`

Get attachment

get_attachment

Full Description

Retrieve an attachment's content by ID.

Parameters (1 required)

Required

idstring

Attachment ID

Get document

get_document

Full Description

Retrieve a Linear document by ID or slug

Parameters (1 required)

Required

idstring

Document ID or slug

Get initiative

get_initiative

Full Description

Retrieve detailed information about a specific initiative in Linear

Parameters (1 required, 2 optional)

Required

querystring

Initiative ID or name

Optional

includeProjectsboolean

Include projects

Default: False

includeSubInitiativesboolean

Include sub-initiatives

Default: False

Get issue

get_issue

Full Description

Retrieve detailed information about an issue by ID, including attachments and git branch name

Parameters (1 required, 2 optional)

Required

idstring

Issue ID or identifier (e.g., LIN-123)

Optional

includeCustomerNeedsboolean

Include associated customer needs

Default: False

includeRelationsboolean

Include blocking/related/duplicate relations

Default: False

Get issue status

get_issue_status

Full Description

Retrieve detailed information about an issue status in Linear by name or ID

Parameters (3 required)

Required

idstring

Status ID

namestring

Status name

teamstring

Team name or ID

Get milestone

get_milestone

Full Description

Retrieve details of a specific milestone by ID or name

Parameters (2 required)

Required

projectstring

Project name, ID, or slug

querystring

Milestone name or ID

Get project

get_project

Full Description

Retrieve details of a specific project in Linear

Parameters (1 required, 3 optional)

Required

querystring

Project name, ID, or slug

Optional

includeMembersboolean

Include project members

Default: False

includeMilestonesboolean

Include milestones

Default: False

includeResourcesboolean

Include resources (documents, links, attachments)

Default: False

Get status updates

get_status_updates

Full Description

List or get project/initiative status updates. Pass id to get a specific update, or filter to list.

Parameters (1 required, 10 optional)

Required

typestring

Type of status update

Options:projectinitiative

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

idstring

Status update ID - if provided, returns this specific update

includeArchivedboolean

Include archived items

Default: False

initiativestring

Initiative name or ID

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

projectstring

Project name, ID, or slug

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

userstring

User ID, name, email, or "me"

Get team

get_team

Full Description

Retrieve details of a specific Linear team

Parameters (1 required)

Required

querystring

Team UUID, key, or name

Get user

get_user

Full Description

Retrieve details of a specific Linear user

Parameters (1 required)

Required

querystring

User ID, name, email, or "me"

List comments

list_comments

Full Description

List comments for a specific Linear issue

Parameters (1 required, 3 optional)

Required

issueIdstring

Issue ID or identifier (e.g., LIN-123)

Optional

cursorstring

Next page cursor

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

List customers

list_customers

Full Description

List customers in the user's Linear workspace

Parameters (0 required, 11 optional)

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

includeArchivedboolean

Include archived items

Default: False

includeNeedsboolean

Include associated customer needs

Default: False

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

ownerstring

User ID, name, email, or "me"

querystring

Search customer name

statusstring

Customer status name or ID

tierstring

Customer tier name or ID

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List cycles

list_cycles

Full Description

Retrieve cycles for a specific Linear team

Parameters (1 required, 1 optional)

Required

teamIdstring

Team ID

Optional

typestring

Filter: current, previous, next, or all

Options:currentpreviousnext

List documents

list_documents

Full Description

List documents in the user's Linear workspace

Parameters (0 required, 10 optional)

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

creatorIdstring

Filter by creator ID

cursorstring

Next page cursor

includeArchivedboolean

Include archived items

Default: False

initiativeIdstring

Filter by initiative ID

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

projectIdstring

Filter by project ID

querystring

Search query

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List initiatives

list_initiatives

Full Description

List initiatives in the user's Linear workspace

Parameters (0 required, 12 optional)

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

includeArchivedboolean

Include archived items

Default: False

includeProjectsboolean

Include projects

Default: False

includeSubInitiativesboolean

Include sub-initiatives

Default: False

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

ownerstring

User ID, name, email, or "me"

parentInitiativestring

Parent initiative name or ID

querystring

Search initiative name

statusstring

Status of the initiative

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List issue labels

list_issue_labels

Full Description

List available issue labels in a Linear workspace or team

Parameters (0 required, 5 optional)

Optional

cursorstring

Next page cursor

limitnumber

Max results (default 50, max 250)

Default: 50

namestring

Filter by name

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

teamstring

Team name or ID

List issue statuses

list_issue_statuses

Full Description

List available issue statuses in a Linear team

Parameters (1 required)

Required

teamstring

Team name or ID

List issues

list_issues

Full Description

List issues in the user's Linear workspace. For my issues, use "me" as the assignee. Use "null" for no assignee.

Parameters (0 required, 16 optional)

Optional

assigneestring

User ID, name, email, or "me"

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

cyclestring

Cycle name, number, or ID

delegatestring

Agent name or ID

includeArchivedboolean

Include archived items

Default: True

labelstring

Label name or ID

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

parentIdstring

Parent issue ID or identifier (e.g., LIN-123)

prioritynumber

0=None, 1=Urgent, 2=High, 3=Normal, 4=Low

projectstring

Project name, ID, or slug

querystring

Search issue title or description

statestring

State type, name, or ID

teamstring

Team name or ID

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List project milestones

list_milestones

Full Description

List all milestones in a Linear project

Parameters (1 required)

Required

projectstring

Project name, ID, or slug

List project labels

list_project_labels

Full Description

List available project labels in the Linear workspace

Parameters (0 required, 4 optional)

Optional

cursorstring

Next page cursor

limitnumber

Max results (default 50, max 250)

Default: 50

namestring

Filter by name

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

List projects

list_projects

Full Description

List projects in the user's Linear workspace

Parameters (0 required, 14 optional)

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

includeArchivedboolean

Include archived items

Default: False

includeMembersboolean

Include project members

Default: False

includeMilestonesboolean

Include milestones

Default: False

initiativestring

Initiative name or ID

labelstring

Label name or ID

limitnumber

Max results (default 50, max 250)

Default: 50

memberstring

User ID, name, email, or "me"

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

querystring

Search project name

statestring

State type, name, or ID

teamstring

Team name or ID

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List teams

list_teams

Full Description

List teams in the user's Linear workspace

Parameters (0 required, 7 optional)

Optional

createdAtstring

Created after: ISO-8601 date/duration (e.g., -P1D)

cursorstring

Next page cursor

includeArchivedboolean

Include archived items

Default: False

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

querystring

Search query

updatedAtstring

Updated after: ISO-8601 date/duration (e.g., -P1D)

List users

list_users

Full Description

Retrieve users in the Linear workspace

Parameters (0 required, 5 optional)

Optional

cursorstring

Next page cursor

limitnumber

Max results (default 50, max 250)

Default: 50

orderBystring

Sort: createdAt | updatedAt

Options:createdAtupdatedAt

Default: updatedAt

querystring

Filter by name or email

teamstring

Team name or ID

Search Linear

research

Full Description

Send a natural-language query to Linear and get a response. Use this tool for complex queries, analytics, multi-step actions, and any request that spans multiple entities or requires reasoning — for example "what's blocking my projects?", "summarize this week's updates for my teams", or "create an issue and assign it to the frontend team". This tool can search, create, and update issues, projects, initiatives, documents, comments, labels, customers, and more. Prefer this tool over making multiple individual API calls when the task involves cross-referencing data, generating summaries, or performing actions that require context. This tool also has access to data that is not exposed through other tools. If you are not able to find the right tool send a query to the research tool to search further. Supports multi-turn conversations by passing the returned conversationId.

Parameters (1 required, 1 optional)

Required

messagestring

A natural-language request or question for Linear, e.g. "list my high-priority issues", "what shipped this week?", or "create a bug for the search team"

Optional

conversationIdstring

Conversation ID for multi-turn conversations

Save comment

save_comment

Full Description

Create or update a comment on a Linear issue. If id is provided, updates the existing comment; otherwise creates a new one. When creating, issueId and body are required.

Parameters (1 required, 3 optional)

Required

bodystring

Content as Markdown

Optional

idstring

Comment ID. If provided, updates the existing comment

issueIdstring

Issue ID or identifier (e.g., LIN-123) (required when creating)

parentIdstring

Parent comment ID (for replies, only when creating)

Save customer

save_customer

Full Description

Create or update a Linear customer. If id is provided, updates the existing customer; otherwise creates a new one. When creating, name is required.

Parameters (0 required, 9 optional)

Optional

domainsarray

Domains to add to this customer. Append-only; existing domains are never removed

externalIdsarray

External system IDs to add. Append-only; existing IDs are never removed

idstring

Customer ID. If provided, updates the existing customer

namestring

Customer name (required when creating)

ownerstring

User ID, name, email, or "me"

revenuenumber

Annual revenue generated by the customer

sizenumber

Size of the customer organization

statusstring

Customer status name or ID

tierstring

Customer tier name or ID

Save customer need

save_customer_need

Full Description

Create or update a customer need (request) in Linear. If id is provided, updates the existing need; otherwise creates a new one. When creating, body is required.

Parameters (0 required, 6 optional)

Optional

bodystring

Description of the customer need (required when creating)

customerstring

Customer ID or name

idstring

Customer need ID. If provided, updates the existing need

issuestring

Issue ID or identifier (e.g., LIN-123) to associate with this need

prioritynumber

Whether the need is important. 0 = Not important, 1 = Important

projectstring

Project ID or name to associate with this need

Save initiative

save_initiative

Full Description

Create or update a Linear initiative. If id is provided, updates the existing initiative; otherwise creates a new one. When creating, name is required.

Parameters (0 required, 10 optional)

Optional

colorstring

Hex color

descriptionstring

Content as Markdown

iconstring

Icon emoji or name

idstring

Initiative ID. If provided, updates the existing initiative

namestring

Initiative name (required when creating)

ownerstring

User ID, name, email, or "me". Null to remove

parentInitiativesarray

Parent initiative names or IDs to add. Appended to existing parents

statusstring

Initiative status (Planned, Active, Completed)

summarystring

Short summary (max 255 chars)

targetDatestring

Target date (ISO format)

Save issue

save_issue

Full Description

Create or update a Linear issue. If id is provided, updates the existing issue; otherwise creates a new one. When creating, title and team are required.

Parameters (0 required, 20 optional)

Optional

assigneestring

User ID, name, email, or "me". Null to remove

blockedByarray

Issue IDs/identifiers blocking this. Append-only; existing relations are never removed

blocksarray

Issue IDs/identifiers this blocks. Append-only; existing relations are never removed

cyclestring

Cycle name, number, or ID

delegatestring

Agent name or ID. Null to remove

descriptionstring

Content as Markdown

dueDatestring

Due date (ISO format)

duplicateOfstring

Duplicate of issue ID/identifier. Null to remove

estimatenumber

Issue estimate value

idstring

Issue ID or identifier (e.g., LIN-123). If provided, updates the existing issue

labelsarray

Label names or IDs

linksarray

Link attachments to add [{url, title}]. Append-only; existing links are never removed

milestonestring

Milestone name or ID

parentIdstring

Parent issue ID or identifier (e.g., LIN-123). Null to remove

prioritynumber

0=None, 1=Urgent, 2=High, 3=Normal, 4=Low

projectstring

Project name, ID, or slug

relatedToarray

Related issue IDs/identifiers. Append-only; existing relations are never removed

statestring

State type, name, or ID

teamstring

Team name or ID (required when creating)

titlestring

Issue title (required when creating)

Save milestone

save_milestone

Full Description

Create or update a milestone in a Linear project. If id is provided, updates the existing milestone; otherwise creates a new one. When creating, name is required.

Parameters (1 required, 4 optional)

Required

projectstring

Project name, ID, or slug

Optional

descriptionstring

Milestone description

idstring

Milestone name or ID

namestring

Milestone name (required when creating)

targetDatestring

Target completion date (ISO format, null to remove)

Save project

save_project

Full Description

Create or update a Linear project. If id is provided, updates the existing project; otherwise creates a new one. When creating, name and at least one team (via addTeams or setTeams) are required.

Parameters (0 required, 18 optional)

Optional

addInitiativesarray

Initiative names/IDs to add

addTeamsarray

Team name or ID to add

colorstring

Hex color

descriptionstring

Content as Markdown

iconstring

Icon emoji (e.g., :eagle:)

idstring

Project ID. If provided, updates the existing project

labelsarray

Label names or IDs

leadstring

User ID, name, email, or "me". Null to remove

namestring

Project name (required when creating)

priorityinteger

0=None, 1=Urgent, 2=High, 3=Medium, 4=Low

removeInitiativesarray

Initiative names/IDs to remove

removeTeamsarray

Team name or ID to remove

setInitiativesarray

Replace all initiatives with these. Cannot combine with addInitiatives/removeInitiatives

setTeamsarray

Replace all teams with these. Cannot combine with addTeams/removeTeams

startDatestring

Start date (ISO format)

statestring

Project state

summarystring

Short summary (max 255 chars)

targetDatestring

Target date (ISO format)

Save status update

save_status_update

Full Description

Create or update a project/initiative status update. Omit id to create, provide id to update.

Parameters (1 required, 6 optional)

Required

typestring

Type of status update

Options:projectinitiative

Optional

bodystring

Content as Markdown

healthstring

onTrack | atRisk | offTrack

Options:onTrackatRiskoffTrack

idstring

Status update ID - if provided, updates this existing update

initiativestring

Initiative name or ID

isDiffHiddenboolean

Hide diff with previous update

projectstring

Project name, ID, or slug

Search

search

Full Description

Full-text search across Linear issues, projects, initiatives, and documents, ranked by relevance. Use this for keyword or natural-language queries (e.g. "memory leak in sync engine"). Supports "quoted phrases" for exact match, -term to exclude, and +term to require. For structured filtering by assignee, status, team, label, etc., use the list_issues or list_projects tools instead.

Parameters (1 required, 3 optional)

Required

querystring

Natural language or keyword search terms (e.g. "billing webhook failure"). Supports "quoted phrases" for exact match, -term for exclusion, and +term for required terms

Optional

includeArchivedboolean

Include archived items

Default: False

limitinteger

Max results (default 10, max 50)

Default: 10

typestring

Optional entity type filter

Options:allissueprojectinitiativedocument

Default: all

Search documentation

search_documentation

Full Description

Search Linear's documentation to learn about features and usage

Parameters (1 required, 1 optional)

Required

querystring

Search query

Optional

pagenumber

Page number

Default: 0

Update document

update_document

Full Description

Update an existing Linear document

Parameters (1 required, 5 optional)

Required

idstring

Document ID or slug

Optional

colorstring

Hex color

contentstring

Content as Markdown

iconstring

Icon emoji

projectstring

Project name, ID, or slug

titlestring

Document title

Links

Website Privacy Policy Terms of Service