- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 78
- Triggers: 0
- Slug:
LINEAR_MCP - Version: 20261018_00
Tools
Create attachment
Create attachment
LINEAR_MCP_CREATE_ATTACHMENTDeprecated fallback for tiny files only. Accepts base64 file content, verifies SHA-256 checksum, and uploads it through the MCP worker. Prefer prepare_attachment_upload plus direct PUT plus create_attachment_from_upload.CRITICAL: Do not print base64Content and then copy it into this tool call. Opaque base64 copied through model-visible text is easy to corrupt.Generate base64Content mechanically from the source bytes and pass it through a programmatic argument construction path whenever available. Before calling this tool, verify the values are consistent:Unix-like shells: file=“/path/to/file” base64Content=$(base64 < “$file” | tr -d ‘\n\r’) sha256=$(shasum -a 256 “$file” | awk ‘{print $1}’) decodedSha256=$(printf ‘%s’ “$base64Content” | base64 -d | shasum -a 256 | awk ‘{print $1}’) size=$(wc -c < “$file” | tr -d ’ ’) # optional; stat can also get file byte size decodedSize=$(printf ‘%s’ “$base64Content” | base64 -d | wc -c | tr -d ’ ’)PowerShell: $file = ‘C:\path\to\file’ $bytes = [IO.File]::ReadAllBytes($file) $base64Content = [Convert]::ToBase64String($bytes) $sha256 = (Get-FileHash -Algorithm SHA256 -Path $file).Hash.ToLower() $size = $bytes.Length # optional $decoded = [Convert]::FromBase64String($base64Content) $decodedStream = [IO.MemoryStream]::new($decoded) $decodedSha256 = (Get-FileHash -Algorithm SHA256 -InputStream $decodedStream).Hash.ToLower() $decodedSize = $decoded.LengthdecodedSha256 must equal sha256. If you pass size, decodedSize must equal size. Pass sha256. Passing size is optional, but recommended for clearer mismatch errors.Input Parameters
Create attachment from upload
Create attachment from upload
LINEAR_MCP_CREATE_ATTACHMENT_FROM_UPLOADLink an already-uploaded Linear assetUrl to an existing issue as an attachment.Use this only after:- prepare_attachment_upload returned an assetUrl and uploadRequest.
- The client successfully PUT raw file bytes to uploadRequest.url.
Input Parameters
Create initiative label
Create initiative label
Create issue label
Create issue label
Delete attachment
Delete attachment
Delete comment
Delete comment
Delete customer
Delete customer
Delete customer need
Delete customer need
Delete diff comment
Delete diff comment
Delete status update
Delete status update
Extract images
Extract images
Get agent skill
Get agent skill
Get attachment
Get attachment
Get diff
Get diff
Get diff threads
Get diff threads
Get document
Get document
Get initiative
Get initiative
Get issue
Get issue
LINEAR_MCP_GET_ISSUERetrieve detailed information about an issue by ID, including attachments, git branch name, and active Triage Intelligence suggestions when the issue is in triageInput Parameters
Get issue status
Get issue status
Get milestone
Get milestone
Get notifications
Get notifications
Get project
Get project
Get release
Get release
Get release note
Get release note
Get status updates
Get status updates
Get team
Get team
Get template
Get template
LINEAR_MCP_GET_TEMPLATERetrieve a Linear template by ID or name: the content it pre-fills, the ids it applies, its sub-issues, and its form fields. Pass the template to save_issue or save_project to apply it. References come back as ids, so read a name with the matching tool when you need one. A form template collects its answers through a form, so applying one here creates an issue with the form unanswered.Input Parameters
Get user
Get user
Get workspace
Get workspace
LINEAR_MCP_GET_WORKSPACERetrieve the connected Linear workspaceList agent skills
List agent skills
List comments
List comments
LINEAR_MCP_LIST_COMMENTSList comments on a Linear issue, project, initiative, document, project milestone, or project/initiative status update. Provide exactly one of issueId, projectId, initiativeId, documentId, milestoneId, or statusUpdateId. For issues, projects, and initiatives this returns both top-level discussion threads and inline description comments. Inline (anchored) comments carry a non-null quotedText set to the snippet of description text they reference. Returned comments include author and nullable onBehalfOf; when set, onBehalfOf identifies the user the agent author acted for.Input Parameters
list_milestones first.get_status_updates first.List customers
List customers
List cycles
List cycles
List diffs
List diffs
List documents
List documents
List initiative labels
List initiative labels
List initiatives
List initiatives
List issue labels
List issue labels
List issues
List issues
LINEAR_MCP_LIST_ISSUESList issues in the user’s Linear workspace, including active Triage Intelligence suggestions for issues in triage. For my issues, use “me” as the assignee. Use “null” for no assignee.Input Parameters
id is always included. Omit or pass an empty array for the default response.List issue statuses
List issue statuses
List milestones
List milestones
List project labels
List project labels
LINEAR_MCP_LIST_PROJECT_LABELSList available project labels in the Linear workspace. A team-scoped label carries a team field; different teams can hold same-named labels, so check it before acting on an ID. A retired label carries retiredAt and cannot be applied to new projects.Input Parameters
List projects
List projects
List release notes
List release notes
List release pipelines
List release pipelines
List releases
List releases
List templates
List templates
List users
List users
Mark notification
Mark notification
Merge diff
Merge diff
Prepare attachment upload
Prepare attachment upload
LINEAR_MCP_PREPARE_ATTACHMENT_UPLOADPrepare a direct Linear file upload for an existing issue.Workflow:- Call this tool with issue, filename, contentType, and size.
- Upload raw bytes with PUT to uploadRequest.url outside MCP.
- All headers in uploadRequest.headers are part of the signed request, so send them verbatim.
- After PUT succeeds, call create_attachment_from_upload with assetUrl to link it to the issue.
-H “content-type: image/png”
-H “x-goog-content-length-range: N,N”
-H “cache-control: public, max-age=31536000”
-H ‘Content-Disposition: attachment; filename=“file.png”’
“<uploadRequest.url>“
Input Parameters
Resolve diff thread
Resolve diff thread
Restore initiative label
Restore initiative label
Restore issue label
Restore issue label
Restore project label
Restore project label
Retire initiative label
Retire initiative label
Retire issue label
Retire issue label
Retire project label
Retire project label
Save comment
Save comment
LINEAR_MCP_SAVE_COMMENTCreate or update a comment on a Linear issue, project, initiative, document, project milestone, or project/initiative status update. If id is provided, updates the existing comment; otherwise creates a new one. To start a new thread, pass body and exactly one of issueId, projectId, initiativeId, documentId, milestoneId, or statusUpdateId — comments on issues/projects/initiatives become top-level discussion threads; comments on documents/milestones become description comments. A status update holds a single thread, so a comment on an update that already has one is added to it as a reply. To reply to an existing thread, pass parentId and body; the reply inherits the parent’s thread type, so no entity reference is needed. Parent reference fields are ignored when id or parentId is provided (statusUpdateType is rejected instead).Input Parameters
list_milestones first.get_status_updates first.Save customer
Save customer
Save customer need
Save customer need
LINEAR_MCP_SAVE_CUSTOMER_NEEDCreate 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.Input Parameters
Save diff comment
Save diff comment
LINEAR_MCP_SAVE_DIFF_COMMENTCreate, reply to, or edit a comment or persisted draft on a Linear diff. Set draft to true to save without submitting. Provide draftId to edit or submit a persisted draft, and commentId only to edit a submitted comment. Submitting an inline draft reuses its saved anchor; submitting a reply draft requires parentId again.Input Parameters
Save document
Save document
LINEAR_MCP_SAVE_DOCUMENTCreate or update a Linear document. If id is provided, edits the existing document; otherwise creates a new one. When creating, title is required and exactly one parent (project, issue, initiative, cycle, or team) must be specified. On update, passing a parent reparents the document. To change parts of the content without resending all of it, pass patch instead of content.Input Parameters
cycle is also passed, in which case it disambiguates the cycle.Save initiative
Save initiative
LINEAR_MCP_SAVE_INITIATIVECreate or update a Linear initiative. If id is provided, updates the existing initiative; otherwise creates a new one. When creating, name is required. To change parts of the description without resending all of it, pass patch instead of description.Input Parameters
Save initiative label
Save initiative label
Save issue
Save issue
LINEAR_MCP_SAVE_ISSUECreate or update a Linear issue. If id is provided, updates the existing issue; otherwise creates a new one. When creating, team is required, and title is required unless template is set. Note: use assignee (not assigneeId) to set the assignee — it accepts a user ID, name, email, or “me”.Input Parameters
description replaces the template body rather than merging with it, but an empty description keeps the template body. Labels merge with the template’s ownSave issue label
Save issue label
LINEAR_MCP_SAVE_ISSUE_LABELCreate or update a Linear issue label. If id is provided, updates the existing label; otherwise creates a new one. When creating, name is required.Input Parameters
id by name; a label’s team cannot be changedSave milestone
Save milestone
Save project
Save project
LINEAR_MCP_SAVE_PROJECTCreate 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. Pass template to create the project from a project template. To change parts of the description without resending all of it, pass patch instead of description.Input Parameters
description replaces the template body rather than merging with it, but an empty description keeps the template body. Labels merge with the template’s ownSave project label
Save project label
Save release
Save release
Save release note
Save release note
LINEAR_MCP_SAVE_RELEASE_NOTECreate or update release notes. If id is provided, updates the existing release notes; otherwise creates a new one. When creating, pipeline and either releases or a release range are required. To change parts of the content without resending all of it, pass patch instead of content.Input Parameters
Save status update
Save status update
LINEAR_MCP_SAVE_STATUS_UPDATECreate or update a project/initiative status update. Omit id to create, provide id to update.Input Parameters
Search documentation
Search documentation
Submit diff review
Submit diff review
LINEAR_MCP_SUBMIT_DIFF_REVIEWApprove a Linear diff, request changes, or submit a review comment