Shipfox
IntegrationsLinear

Linear tools

Look up the Linear tools, selectors, permissions, inputs, and outputs available to tool steps and agent steps.

This reference lists the shipped Linear tool catalog. See the Linear overview for authentication and setup.

Tool catalog

The catalog uses Linear's OAuth scopes. Read tools require read access. Write tools require write access.

Attachments

readget_attachment

Retrieve a Linear attachment by ID.

Requiresread

Parameters

idstringRequired

Attachment ID

readdownload_file

Download a file uploaded to Linear. The URL must start with https://uploads.linear.app/, as in issue, comment, and document bodies. Signed URLs are accepted.

Requiresread

Parameters

urlstringRequired

Linear upload URL

readextract_images

Extract and fetch images from markdown content.

Requiresread

Parameters

markdownstringRequired

Markdown content containing image references

writecreate_attachment

Upload a tiny file through the MCP worker and attach it to a Linear issue.

RequireswriteSensitive

Parameters

base64ContentstringRequired

Deprecated base64-encoded file content to upload

contentTypestringRequired

MIME type for the upload

filenamestringRequired

Filename for the upload

issuestringRequired

Issue ID or identifier

sha256stringRequired

Expected SHA-256 hex digest of the decoded file bytes

sizenumber

Expected decoded file size in bytes

subtitlestring

Attachment subtitle

titlestring

Attachment title

writecreate_attachment_from_upload

Link an already-uploaded Linear asset URL to an existing issue as an attachment.

RequireswriteSensitive

Parameters

assetUrlstringRequired

Linear upload asset URL returned by prepare_attachment_upload

issuestringRequired

Issue ID or identifier

subtitlestring

Attachment subtitle

titlestring

Attachment title

writeprepare_attachment_upload

Prepare a direct Linear file upload for an existing issue.

RequireswriteSensitive

Parameters

contentTypestringRequired

MIME type for the upload

filenamestringRequired

Filename for the upload

issuestringRequired

Issue ID or identifier

sizenumberRequired

Exact file size in bytes

subtitlestring

Suggested attachment subtitle for the finalize step

titlestring

Suggested attachment title for the finalize step

writedelete_attachment

Delete a Linear attachment.

RequireswriteSensitive

Parameters

idstringRequired

Attachment ID

Agents

readget_agent_skill

Retrieve a Linear Agent skill by ID, including its full markdown instructions.

Requiresread

Parameters

idstringRequired

Agent skill ID

readlist_agent_skills

List Linear Agent skills available to the authenticated user.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

Diffs

readget_diff

Look up a Linear diff by review URL, GitHub PR URL, identifier, UUID, or slug.

Requiresread

Parameters

urlOrIdstringRequired

Linear review URL, diff slug, pull request ID, Linear identifier, or GitHub PR URL

readget_diff_threads

Look up Linear diff threads by review URL, GitHub PR URL, identifier, UUID, or slug.

Requiresread

Parameters

orderBystring

Sort order

Possible values: createdAt, updatedAt

resolvedboolean

Filter returned threads by resolved state

threadIdstring

Top-level thread or comment ID to return

urlOrIdstringRequired

Linear review URL, diff slug, pull request ID, Linear identifier, or GitHub PR URL

readlist_diffs

List Linear diff pull requests visible to the authenticated user.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

ownerstring

Repository owner

querystring

Search by title, branch, PR number, or bare slug

repostring

Repository name

statusstring

Pull request status

Documents

readget_document

Retrieve a Linear document by ID or slug.

Requiresread

Parameters

idstringRequired

Document ID or slug

readlist_documents

List documents in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

creatorIdstring

Creator ID

includeArchivedboolean

Include archived documents

initiativeIdstring

Initiative ID

projectIdstring

Project ID

querystring

Search query

teamIdstring

Team ID

writesave_document

Create or update a Linear document.

RequireswriteSensitive

Parameters

colorstring

Hex color

contentstring

Document content as Markdown

cyclestring

Cycle name, number, or ID

iconstring

Icon name or emoji code

idstring

Document ID or slug

initiativestring

Initiative name or ID

issuestring

Issue ID or identifier

projectstring

Project name, ID, or slug

teamstring

Team name or ID

titlestring

Document title

Issues

readget_issue

Retrieve detailed information about a Linear issue.

Requiresread

Parameters

idstringRequired

Issue ID or identifier

includeCustomerNeedsboolean

Include associated customer needs

includeRelationsboolean

Include blocking, related, and duplicate relations

includeReleasesboolean

Include associated releases

readlist_issues

List Linear issues visible to the authenticated connection.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

assigneestring | null
cyclestring

Cycle name, number, or ID

delegatestring

Agent name or ID

includeArchivedboolean

Include archived issues

labelstring

Label name or ID

parentIdstring

Parent issue ID or identifier

prioritynumber

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

projectstring

Project name, ID, or slug

querystring

Search issue title or description

releasestring

Release ID or slug

statestring

State type, name, or ID

teamstring

Team name or ID

readlist_issue_labels

List issue labels in a Linear workspace or team.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

namestring

Filter by label name

teamstring

Team name or ID

readlist_issue_statuses

List available issue statuses in a Linear team.

Requiresread

Parameters

teamstringRequired

Team name or ID

readget_issue_status

Retrieve detailed information about an issue status by name or ID.

Requiresread

Parameters

idstringRequired

Status ID

namestringRequired

Status name

teamstringRequired

Team name or ID

writesave_issue

Create or update a Linear issue.

Requireswrite

Parameters

addReleasesarray of string
assigneestring | null
blockedByarray of string
blocksarray of string
cyclestring | null
delegatestring | null
descriptionstring

Issue description as Markdown

dueDatestring

Due date in ISO format

duplicateOfstring | null
estimatenumber | null

Issue estimate value

idstring

Issue ID or identifier

labelsarray of string
linksarray of object
Show 2 attributes
titlestringRequired

Attachment title

urlstringRequired

Attachment URL

milestonestring

Milestone name or ID

parentIdstring | null
prioritynumber

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

projectstring | null
relatedToarray of string
removeBlockedByarray of string
removeBlocksarray of string
removeRelatedToarray of string
removeReleasesarray of string
setReleasesarray of string
statestring

State type, name, or ID

teamstring

Team name or ID

titlestring

Issue title

writecreate_issue_label

Create a new Linear issue label.

RequireswriteSensitive

Parameters

colorstring

Hex color code

descriptionstring

Label description

isGroupboolean

Is label group

namestringRequired

Label name

parentstring

Parent label group name

teamIdstring

Team UUID

Comments

readlist_comments

List comments on a Linear issue, project, initiative, document, or milestone.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

documentIdstring

Document ID or slug

initiativeIdstring

Initiative name or ID

issueIdstring

Issue ID or identifier

milestoneIdstring

Milestone UUID

projectIdstring

Project name, ID, or slug

writesave_comment

Create or update a comment on a Linear issue, project, initiative, document, or milestone.

Requireswrite

Parameters

bodystringRequired

Comment body as Markdown

documentIdstring

Document ID or slug

idstring

Comment ID

initiativeIdstring

Initiative name or ID

issueIdstring

Issue ID or identifier

milestoneIdstring

Milestone UUID

parentIdstring

Parent comment ID

projectIdstring

Project name, ID, or slug

writedelete_comment

Delete a Linear comment.

RequireswriteSensitive

Parameters

idstringRequired

Comment ID

Workspace

readlist_teams

List teams in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

includeArchivedboolean

Include archived teams

querystring

Search query

readget_team

Retrieve detailed information about a Linear team.

Requiresread

Parameters

querystringRequired

Team UUID, key, or name

readlist_users

Retrieve users in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

querystring

Filter by name or email

teamstring

Team name or ID

readget_user

Retrieve details of a specific Linear user.

Requiresread

Parameters

querystringRequired

User ID, name, email, or "me"

Projects

readlist_projects

List projects in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

includeArchivedboolean

Include archived projects

includeMembersboolean

Include project members

includeMilestonesboolean

Include milestones

initiativestring

Initiative name or ID

labelstring

Label name or ID

memberstring

User ID, name, email, or "me"

querystring

Search project name

statestring

State type, name, or ID

teamstring

Team name or ID

readget_project

Retrieve details of a specific Linear project.

Requiresread

Parameters

includeMembersboolean

Include project members

includeMilestonesboolean

Include milestones

includeResourcesboolean

Include documents, links, and attachments

querystringRequired

Project name, ID, or slug

readlist_project_labels

List project labels in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

namestring

Filter by label name

readlist_milestones

List milestones in a Linear project.

Requiresread

Parameters

projectstringRequired

Project name, ID, or slug

readget_milestone

Retrieve details of a Linear milestone by ID or name.

Requiresread

Parameters

projectstringRequired

Project name, ID, or slug

querystringRequired

Milestone name or ID

readget_status_updates

List or retrieve project or initiative status updates.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

idstring

Status update ID

includeArchivedboolean

Include archived updates

initiativestring

Initiative name or ID

projectstring

Project name, ID, or slug

typestringRequired

Status update type

Possible values: project, initiative

userstring

User ID, name, email, or "me"

writesave_project

Create or update a Linear project.

RequireswriteSensitive

Parameters

addInitiativesarray of string
addTeamsarray of string
colorstring

Hex color

descriptionstring

Project description as Markdown

iconstring

Icon name or emoji code

idstring

Project ID

labelsarray of string
leadstring | null
namestring

Project name

prioritynumber

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

removeInitiativesarray of string
removeTeamsarray of string
setInitiativesarray of string
setTeamsarray of string
startDatestring

Start date in ISO format

startDateResolutionstring

Start date resolution

Possible values: halfYear, month, quarter, year

statestring

Project state

summarystring

Short summary

targetDatestring

Target date in ISO format

targetDateResolutionstring

Target date resolution

Possible values: halfYear, month, quarter, year

writesave_milestone

Create or update a Linear milestone in a project.

RequireswriteSensitive

Parameters

descriptionstring

Milestone description

idstring

Milestone name or ID

namestring

Milestone name

projectstringRequired

Project name, ID, or slug

targetDatestring | null
writesave_status_update

Create or update a project or initiative status update.

RequireswriteSensitive

Parameters

bodystring

Status update body as Markdown

healthstring

Status update health

Possible values: onTrack, atRisk, offTrack

idstring

Status update ID

initiativestring

Initiative name or ID

isDiffHiddenboolean

Hide diff with previous update

projectstring

Project name, ID, or slug

typestringRequired

Status update type

Possible values: project, initiative

writedelete_status_update

Delete or archive a Linear project or initiative status update.

RequireswriteSensitive

Parameters

idstringRequired

Status update ID

typestringRequired

Status update type

Possible values: project, initiative

Releases

readget_release

Retrieve details of a Linear release by ID or slug.

Requiresread

Parameters

idstringRequired

Release ID or slug

includeReleaseNotesboolean

Include associated release notes

readlist_release_pipelines

List release pipelines in the Linear workspace.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

includeArchivedboolean

Include archived release pipelines

includeStagesboolean

Include each pipeline stages

includeTeamsboolean

Include each pipeline teams

isProductionboolean

Filter by production pipeline flag

querystring

Search pipeline name

teamstring

Team name or ID

typestring

Pipeline type

Possible values: continuous, scheduled

readlist_releases

List releases in the workspace, with optional filtering by pipeline, stage, version, and text.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

hasReleaseNotesboolean

Filter to releases that do or do not have release notes

includeArchivedboolean

Include archived releases

includeReleaseNotesboolean

Include associated release notes

pipelinestring

Release pipeline ID, slug, or exact name

querystring

Search release name or version

stagestring

Release stage ID or exact name

stageTypestring

Stage lifecycle type

Possible values: planned, started, completed, canceled

versionstring

Exact version match

writesave_release

Create or update a Linear release.

RequireswriteSensitive

Parameters

commitShastring

Commit SHA associated with the release

completedAtstring | null

Completed timestamp in ISO DateTime format

createdAtstring

Import or create timestamp in ISO DateTime format

descriptionstring

Release description

idstring

Release ID or slug to update

namestring

Release name

pipelinestring

Release pipeline ID, slug, or exact name

stagestring

Release stage ID, exact name, or lifecycle type within the pipeline

startDatestring | null

Estimated start date in ISO YYYY-MM-DD format

startedAtstring | null

Started timestamp in ISO DateTime format

targetDatestring | null

Estimated completion date in ISO YYYY-MM-DD format

versionstring

Version identifier

Release notes

readget_release_note

Retrieve Linear release notes by ID or slug, including markdown content.

Requiresread

Parameters

idstringRequired

Release notes ID or slug

includeReleasesboolean

Include associated releases

readlist_release_notes

List release notes in the workspace, optionally filtered by pipeline or release.

Requiresread

Parameters

cursorstring

Next page cursor

limitnumber

Maximum number of results to return

orderBystring

Sort order

Possible values: createdAt, updatedAt

createdAtstring

ISO-8601 date or duration filter

updatedAtstring

ISO-8601 date or duration filter

includeArchivedboolean

Include archived release notes

includeContentboolean

Include markdown release notes content

includeReleasesboolean

Include associated releases

pipelinestring

Release pipeline ID, slug, or exact name

querystring

Search release notes title

releasestring

Release ID or slug

writesave_release_note

Create or update Linear release notes.

RequireswriteSensitive

Parameters

contentstring

Release notes content as Markdown

idstring

Release notes ID or slug to update

pipelinestring

Release pipeline ID, slug, or exact name

rangeFromReleasestring

Oldest release ID or slug in the note range

rangeToReleasestring

Newest release ID or slug in the note range

releasesarray of string
titlestring

Release notes title

Cycles

readlist_cycles

Retrieve cycles for a specific Linear team.

Requiresread

Parameters

teamIdstringRequired

Team ID

typestring

Cycle filter

Possible values: current, previous, next

Documentation

readsearch_documentation

Search Linear's documentation to learn about features and usage.

Requiresread

Parameters

pagenumber

Page number

querystringRequired

Search query

Was this page helpful?
Edit this page on GitHub

Events

See which Linear events can start a workflow and what each event contains.

Jira integration

Connect Jira Cloud to trigger workflows from issue and comment events, and call Jira tools from workflows.

On this page

Tool catalogAttachmentsreadget_attachmentreaddownload_filereadextract_imageswritecreate_attachmentwritecreate_attachment_from_uploadwriteprepare_attachment_uploadwritedelete_attachmentAgentsreadget_agent_skillreadlist_agent_skillsDiffsreadget_diffreadget_diff_threadsreadlist_diffsDocumentsreadget_documentreadlist_documentswritesave_documentIssuesreadget_issuereadlist_issuesreadlist_issue_labelsreadlist_issue_statusesreadget_issue_statuswritesave_issuewritecreate_issue_labelCommentsreadlist_commentswritesave_commentwritedelete_commentWorkspacereadlist_teamsreadget_teamreadlist_usersreadget_userProjectsreadlist_projectsreadget_projectreadlist_project_labelsreadlist_milestonesreadget_milestonereadget_status_updateswritesave_projectwritesave_milestonewritesave_status_updatewritedelete_status_updateReleasesreadget_releasereadlist_release_pipelinesreadlist_releaseswritesave_releaseRelease notesreadget_release_notereadlist_release_noteswritesave_release_noteCyclesreadlist_cyclesDocumentationreadsearch_documentation