Skip to main content
Linear MCP logo
  • Category: model context protocol
  • Auth: DCR_OAUTH
  • Composio-managed OAuth available? No
  • Tools: 78
  • Triggers: 0
  • Slug: LINEAR_MCP
  • Version: 20261018_00

Tools

Slug: 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

integer
Optional expected decoded file size in bytes. Rejects the upload if it does not match.
string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
string
Optional title for the attachment
string
required
Expected SHA-256 hex digest of the decoded file bytes.
string
required
Filename for the upload (e.g., ‘screenshot.png’)
string
Optional subtitle for the attachment
string
required
MIME type for the upload (e.g., ‘image/png’, ‘application/pdf’)
string
required
Deprecated base64-encoded file content to upload
Slug: LINEAR_MCP_CREATE_ATTACHMENT_FROM_UPLOADLink an already-uploaded Linear assetUrl to an existing issue as an attachment.Use this only after:
  1. prepare_attachment_upload returned an assetUrl and uploadRequest.
  2. The client successfully PUT raw file bytes to uploadRequest.url.
This tool does not upload file content. It only creates the Linear attachment row. If the direct upload failed or the signed URL expired, rerun prepare_attachment_upload and upload again.

Input Parameters

string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
string
Attachment title. Defaults to filename or asset URL
string
required
Linear upload assetUrl returned by prepare_attachment_upload
string
Optional attachment subtitle
Slug: LINEAR_MCP_CREATE_INITIATIVE_LABELCreate a new Linear initiative label. Deprecated: use save_initiative_label, which can also update labels.

Input Parameters

string
required
Label name
string
Hex color code
string
Parent label group name or ID
boolean
Whether the label is a group
string
Label description
Slug: LINEAR_MCP_CREATE_ISSUE_LABELCreate a new Linear issue label. Deprecated: use save_issue_label, which can also update labels.

Input Parameters

string
required
Label name
string
Hex color code
string
Parent label group name or ID
string
Team UUID (omit for workspace label)
boolean
Whether the label is a group
string
Label description
Slug: LINEAR_MCP_DELETE_ATTACHMENTDelete an attachment by ID

Input Parameters

string
required
Attachment ID
Slug: LINEAR_MCP_DELETE_COMMENTDelete a Linear comment. Inline description comments (those with non-null quotedText) anchor a mark in the editor, so their root cannot be deleted — delete the replies individually or resolve the thread instead.

Input Parameters

string
required
Comment ID
Slug: LINEAR_MCP_DELETE_CUSTOMERDelete a customer in Linear

Input Parameters

string
required
Customer ID
Slug: LINEAR_MCP_DELETE_CUSTOMER_NEEDArchive a customer need in Linear

Input Parameters

string
required
Customer need ID
Slug: LINEAR_MCP_DELETE_DIFF_COMMENTDelete a comment or persisted draft from a Linear diff

Input Parameters

string
Persisted diff comment draft ID to delete
string
Submitted diff comment ID to delete
Slug: LINEAR_MCP_DELETE_STATUS_UPDATEDelete (archive) a project or initiative status update.

Input Parameters

string
required
Status update ID
string ("project" | "initiative")
required
Type of status update
Slug: LINEAR_MCP_EXTRACT_IMAGESExtract 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.

Input Parameters

string
required
Markdown content containing image references (e.g., issue description, comment body)
Slug: LINEAR_MCP_GET_AGENT_SKILLRetrieve a Linear Agent skill by ID, including its full markdown instructions.

Input Parameters

string
required
Agent skill ID
Slug: LINEAR_MCP_GET_ATTACHMENTRetrieve an attachment’s content by ID.

Input Parameters

string
required
Attachment ID
Slug: LINEAR_MCP_GET_DIFFExact lookup for a Linear diff. Use with review URLs, GitHub PR URLs, Linear full identifiers, UUIDs, or slugs.

Input Parameters

string
required
Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL
Slug: LINEAR_MCP_GET_DIFF_THREADSExact lookup for diff threads and the authenticated user’s drafts. Use with review URLs, GitHub PR URLs, Linear full identifiers, UUIDs, or slugs.

Input Parameters

string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
required
Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL
boolean
Filter returned threads by resolved state
string
Optional Linear comment UUID of any comment in the thread (not its externalThreadId); a reply’s UUID resolves to its thread root
Slug: LINEAR_MCP_GET_DOCUMENTRetrieve a Linear document by ID or slug

Input Parameters

string
required
Document ID or slug
Slug: LINEAR_MCP_GET_INITIATIVERetrieve detailed information about a specific initiative in Linear

Input Parameters

string
required
Initiative name, ID, identifier (e.g., I-123), or slug
boolean
Include projects
boolean
Include sub-initiatives
Slug: 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 triage

Input Parameters

string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
boolean
Include associated releases
boolean
Include blocking/related/duplicate relations
boolean
Include associated customer needs
Slug: LINEAR_MCP_GET_ISSUE_STATUSRetrieve detailed information about an issue status in Linear by name or ID

Input Parameters

string
required
Status ID
string
required
Status name
string
required
Team name or ID
Slug: LINEAR_MCP_GET_MILESTONERetrieve details of a specific milestone by ID or name

Input Parameters

string
required
Milestone name or ID
string
required
Project name, ID, identifier (e.g., P-ENG-123), or slug
Slug: LINEAR_MCP_GET_NOTIFICATIONSGet a page of notifications from the authenticated user’s Linear inbox.

Input Parameters

number
Max results (default 50, max 250)
string
Next page cursor
boolean
Only return unread notifications
Slug: LINEAR_MCP_GET_PROJECTRetrieve details of a specific project in Linear

Input Parameters

string
required
Project name, ID, identifier (e.g., P-ENG-123), or slug
boolean
Include project members
boolean
Include resources (documents, links, attachments)
boolean
Include milestones
Slug: LINEAR_MCP_GET_RELEASERetrieve details of a release by ID or slug.

Input Parameters

string
required
Release ID or slug
boolean
Include associated release notes
Slug: LINEAR_MCP_GET_RELEASE_NOTERetrieve release notes by ID or slug, including markdown content.

Input Parameters

string
required
Release notes ID or slug
boolean
Include associated releases
Slug: LINEAR_MCP_GET_STATUS_UPDATESList or get project/initiative status updates. Pass id to get a specific update, or filter to list.

Input Parameters

string
Status update ID - if provided, returns this specific update
string ("project" | "initiative")
required
Type of status update
string
User ID, name, email, or “me”
number
Max results (default 50, max 250)
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Project name, ID, identifier (e.g., P-ENG-123), or slug
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
string
Initiative name, ID, identifier (e.g., I-123), or slug
boolean
Include archived items
Slug: LINEAR_MCP_GET_TEAMRetrieve details of a specific Linear team

Input Parameters

string
required
Team UUID, key, or name
Slug: 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

string
required
Template ID or name
Slug: LINEAR_MCP_GET_USERRetrieve details of a specific Linear user

Input Parameters

string
required
User ID, name, email, or “me”
Slug: LINEAR_MCP_GET_WORKSPACERetrieve the connected Linear workspace
Slug: LINEAR_MCP_LIST_AGENT_SKILLSList Linear Agent skills available to the authenticated user.

Input Parameters

number
Max results (default 50, max 250)
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
Slug: 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

number
Max results (default 50, max 250)
string
Next page cursor
string
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues (provide exactly one parent)
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Project name, ID, identifier (e.g., P-ENG-123), or slug (provide exactly one parent)
string
Document ID or slug (provide exactly one parent)
string
Milestone UUID (provide exactly one parent). Resolve milestone names via list_milestones first.
string
Initiative name, ID, identifier (e.g., I-123), or slug (provide exactly one parent)
string
Status update UUID (provide exactly one parent). Resolve status updates via get_status_updates first.
string ("project" | "initiative")
Type of status update named by statusUpdateId, as returned by get_status_updates. Only valid together with statusUpdateId; omit to check both project and initiative status updates.
Slug: LINEAR_MCP_LIST_CUSTOMERSList customers in the user’s Linear workspace

Input Parameters

string
Customer tier name or ID
number
Max results (default 50, max 250)
string
User ID, name, email, or “me”
string
Search customer name
string
Next page cursor
string
Customer status name or ID
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include associated customer needs
boolean
Include archived items
Slug: LINEAR_MCP_LIST_CYCLESRetrieve cycles for a specific Linear team

Input Parameters

string ("current" | "previous" | "next")
Filter: current, previous, next, or all
string
required
Team ID
Slug: LINEAR_MCP_LIST_DIFFSList Linear diff pull requests visible to the authenticated user

Input Parameters

string
Filter returned diffs by repository name
number
Max results (default 50, max 250)
string
Filter returned diffs by repository owner
string
Broad search by title, branch, PR number, or bare slug
string
Filter by author ID, name, email, or “me”
string
Next page cursor
string
Filter returned diffs by pull request status
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Filter by reviewer ID, name, email, or “me”
string ("pending" | "approved" | "changesRequested" | "commented" | "dismissed")
Reviewer state; requires reviewer and defaults to pending when reviewer is set
Slug: LINEAR_MCP_LIST_DOCUMENTSList documents in the user’s Linear workspace

Input Parameters

number
Max results (default 50, max 250)
string
Search query
string
Next page cursor
array
Fields to include in each result. id is always included. Omit or pass an empty array for the default response.
string
Filter by team ID
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Filter by creator ID
string
Filter by project ID
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
string
Filter by initiative ID
boolean
Include archived items
Slug: LINEAR_MCP_LIST_INITIATIVE_LABELSList available initiative labels in the Linear workspace. A retired label carries retiredAt and cannot be applied to new initiatives.

Input Parameters

string
Filter by name
number
Max results (default 50, max 250)
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
boolean
Include label groups in the results, marked with isGroup. A group cannot be applied directly; retiring or restoring one cascades to its child labels
Slug: LINEAR_MCP_LIST_INITIATIVESList initiatives in the user’s Linear workspace

Input Parameters

string
Label name or ID
number
Max results (default 50, max 250)
string
User ID, name, email, or “me”
string
Search initiative name
string
Next page cursor
array
Fields to include in each result. id is always included. Omit or pass an empty array for the default response.
string
Status of the initiative
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Lead team name, key, or ID
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include archived items
boolean
Include projects
string
Parent initiative. Initiative name, ID, identifier (e.g., I-123), or slug
boolean
Include sub-initiatives
Slug: LINEAR_MCP_LIST_ISSUE_LABELSList available issue labels in a Linear workspace or team. A retired label carries retiredAt and cannot be applied to new issues.

Input Parameters

string
Filter by name
string
Team name or ID
number
Max results (default 50, max 250)
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
boolean
Include label groups in the results, marked with isGroup. A group cannot be applied directly; retiring or restoring one cascades to its child labels
Slug: 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

string
Team name or ID
string
Cycle name, number, or ID
string
Label name or ID
number
Max results (default 50, max 250)
string
Search issue title or description
string
State type, name, or ID
string
Next page cursor
array
Fields to include in each result. id is always included. Omit or pass an empty array for the default response.
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Project name, ID, identifier (e.g., P-ENG-123), or slug
string
Release ID or slug
string
User ID, name, email, or “me”
string
Agent name or ID. When the user asks to delegate to “Linear” or “the Linear agent”, this refers to the “Linear” app user specifically
string
Parent issue ID or identifier (e.g., LIN-123)
number
0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include archived items
Slug: LINEAR_MCP_LIST_ISSUE_STATUSESList available issue statuses in a Linear team

Input Parameters

string
required
Team name or ID
Slug: LINEAR_MCP_LIST_MILESTONESList all milestones in a Linear project

Input Parameters

string
required
Project name, ID, identifier (e.g., P-ENG-123), or slug
Slug: 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

string
Filter by name
number
Max results (default 50, max 250)
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
boolean
Include label groups in the results, marked with isGroup. A group cannot be applied directly; retiring or restoring one cascades to its child labels
Slug: LINEAR_MCP_LIST_PROJECTSList projects in the user’s Linear workspace

Input Parameters

string
Team name or ID
string
Label name or ID
number
Max results (default 50, max 50)
string
Search project name
string
State type, name, or ID
string
Next page cursor
array
Fields to include in each result. id is always included. Omit or pass an empty array for the default response.
string
User ID, name, email, or “me”
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
string
Initiative name, ID, identifier (e.g., I-123), or slug
boolean
Include project members
boolean
Include archived items
boolean
Include milestones
Slug: LINEAR_MCP_LIST_RELEASE_NOTESList release notes in the workspace, optionally filtered by pipeline or covered release.

Input Parameters

number
Max results (default 50, max 250)
string
Search release notes title
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Release ID or slug
string
Release pipeline ID, slug, or exact name
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include markdown release notes content
boolean
Include archived items
boolean
Include associated releases
Slug: LINEAR_MCP_LIST_RELEASE_PIPELINESList release pipelines in the workspace.

Input Parameters

string
Team name or ID
string ("continuous" | "scheduled")
Pipeline type: continuous | scheduled
number
Max results (default 50, max 250)
string
Search pipeline name
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include each pipeline’s teams
boolean
Filter by production pipeline flag
boolean
Include each pipeline’s stages
boolean
Include archived items
Slug: LINEAR_MCP_LIST_RELEASESList releases in the workspace, with optional filtering by pipeline, stage, version, and text.

Input Parameters

number
Max results (default 50, max 250)
string
Search release name or version
string
Release stage ID or exact name
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Exact version match
string
Release pipeline ID, slug, or exact name
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string ("planned" | "started" | "completed" | "canceled")
Filter by stage lifecycle type
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Filter to releases that do (true) or do not (false) have release notes
boolean
Include archived items
boolean
Include associated release notes
Slug: LINEAR_MCP_LIST_TEAMSList teams in the user’s Linear workspace

Input Parameters

number
Max results (default 50, max 250)
string
Search query
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
string
Created after: ISO-8601 date/duration (e.g., -P1D)
string
Updated after: ISO-8601 date/duration (e.g., -P1D)
boolean
Include archived items
Slug: LINEAR_MCP_LIST_TEMPLATESList the Linear issue, project, and document templates available to the authenticated user. Use this to find the template a team expects, then call get_template for its content.

Input Parameters

string
Team name or ID. Returns that team’s templates plus workspace-level ones
string ("issue" | "project" | "document")
Filter by template type. Omit to return every type
Slug: LINEAR_MCP_LIST_USERSRetrieve users in the Linear workspace

Input Parameters

string
Team name or ID
number
Max results (default 50, max 250)
string
Filter by name or email
string
Next page cursor
string ("createdAt" | "updatedAt")
Sort: createdAt | updatedAt
Slug: LINEAR_MCP_MARK_NOTIFICATIONMark a Linear inbox notification as read or unread, or snooze or unsnooze it.

Input Parameters

string
required
Notification ID
boolean
Whether the notification should be marked as read
string
ISO-8601 time to snooze until, or null to unsnooze
Slug: LINEAR_MCP_MERGE_DIFFMerge a Linear diff or add it to the repository’s merge queue

Input Parameters

string
required
Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL
string ("MERGE" | "REBASE" | "SQUASH")
Merge method; omit to use the repository default
Slug: LINEAR_MCP_PREPARE_ATTACHMENT_UPLOADPrepare a direct Linear file upload for an existing issue.Workflow:
  1. Call this tool with issue, filename, contentType, and size.
  2. Upload raw bytes with PUT to uploadRequest.url outside MCP.
  3. All headers in uploadRequest.headers are part of the signed request, so send them verbatim.
  4. After PUT succeeds, call create_attachment_from_upload with assetUrl to link it to the issue.
Do not base64-encode or transform the file. Use curl —data-binary @path or fetch(url, { method: ‘PUT’, body: blob }). Omitting or modifying any signed header, including casing, will return HTTP 403. The signed URL must be used within 60 seconds or it will expire.Upload sequencing: Prepare, PUT, and finalize one file before calling this tool for another file. Do not batch multiple prepare_attachment_upload calls before starting the PUTs because earlier signed URLs can expire while later files are prepared.Example: curl -X PUT —data-binary @file.png
-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

integer
required
Exact file size in bytes. Must be smaller than 2 GB.
string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
string
Suggested attachment title for the finalize step
string
required
Filename for the upload, e.g. screenshot.png
string
Suggested attachment subtitle for the finalize step
string
required
MIME type, e.g. image/png or application/pdf
Slug: LINEAR_MCP_RESOLVE_DIFF_THREADResolve or reopen a top-level comment thread on a Linear diff

Input Parameters

boolean
True to resolve the thread; false to reopen it
string
required
Top-level diff thread/comment ID
Slug: LINEAR_MCP_RESTORE_INITIATIVE_LABELRestore a retired Linear initiative label, making it available for use on initiatives again. Restoring a label group also restores every child label, including any that were retired separately.

Input Parameters

string
required
Label or label group ID
Slug: LINEAR_MCP_RESTORE_ISSUE_LABELRestore a retired Linear issue label, making it available for use on issues again. Restoring a label group also restores every child label, including any that were retired separately.

Input Parameters

string
required
Label or label group ID
Slug: LINEAR_MCP_RESTORE_PROJECT_LABELRestore a retired Linear project label, making it available for use on projects again. Restoring a label group also restores every child label, including any that were retired separately.

Input Parameters

string
required
Label or label group ID
Slug: LINEAR_MCP_RETIRE_INITIATIVE_LABELRetire a Linear initiative label so it cannot be applied to new initiatives. The label stays visible on initiatives that already have it. Retiring a label group also retires its child labels. Undo with restore_initiative_label.

Input Parameters

string
required
Label or label group ID
Slug: LINEAR_MCP_RETIRE_ISSUE_LABELRetire a Linear issue label so it cannot be applied to new issues. The label stays visible on issues that already have it. Retiring a label group also retires its child labels. Undo with restore_issue_label.

Input Parameters

string
required
Label or label group ID
Slug: LINEAR_MCP_RETIRE_PROJECT_LABELRetire a Linear project label so it cannot be applied to new projects. The label stays visible on projects that already have it. Retiring a label group also retires its child labels. Undo with restore_project_label.

Input Parameters

string
required
Label or label group ID
Slug: 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

string
Comment ID. If provided, updates the existing comment
string
required
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
string
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues (provide exactly one parent)
string
Parent comment ID (for replies, only when creating)
string
Project name, ID, identifier (e.g., P-ENG-123), or slug (provide exactly one parent)
string
Document ID or slug (provide exactly one parent)
string
Milestone UUID (provide exactly one parent). Resolve milestone names via list_milestones first.
string
Initiative name, ID, identifier (e.g., I-123), or slug (provide exactly one parent)
string
Status update UUID (provide exactly one parent). Resolve status updates via get_status_updates first.
string ("project" | "initiative")
Type of status update named by statusUpdateId, as returned by get_status_updates. Only valid together with statusUpdateId; omit to check both project and initiative status updates.
Slug: LINEAR_MCP_SAVE_CUSTOMERCreate or update a Linear customer. If id is provided, updates the existing customer; otherwise creates a new one. When creating, name is required.

Input Parameters

string
Customer ID. If provided, updates the existing customer
string
Customer name (required when creating)
number
Size of the customer organization
string
Customer tier name or ID
string
User ID, name, email, or “me”
string
Customer status name or ID
array
Domains to add to this customer. Append-only; existing domains are never removed
number
Annual revenue generated by the customer
array
External system IDs to add. Append-only; existing IDs are never removed
Slug: 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

string
Customer need ID. If provided, updates the existing need
string
Description of the customer need (required when creating)
string
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues to associate with this need
string
URL to attach as the source for this customer need, such as a transcript or support thread
string
Project name, ID, identifier (e.g., P-ENG-123), or slug to associate with this need
string
Customer ID or name
number
Whether the need is important. 0 = Not important, 1 = Important
Slug: 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

string
required
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences
boolean
Save as a private persisted draft without submitting
object
Optional comment anchor copied from a diff thread or built for a file or diff hunk
string
Existing persisted draft ID to edit or submit
string
Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL
string
Top-level comment ID to reply to; also required when submitting a persisted reply draft
string
Existing comment ID to edit
string
Exact source text of the anchor’s end line; stored with an inline draft so it can be re-anchored after the diff receives new revisions
Slug: 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

string
Document ID or slug to update. Omit to create a new document.
string
Icon name or emoji code (e.g. “Rocket” or “:eagle:”), not a raw Unicode emoji
string
Team name or ID. Attaches the document to the team, unless cycle is also passed, in which case it disambiguates the cycle.
string
Hex color
string
Cycle name, number, or ID. When passing a name or number, also pass team to disambiguate.
string
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
array
Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field
string
Document title (required when creating)
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
string
Project name, ID, identifier (e.g., P-ENG-123), or slug
string
Initiative name, ID, identifier (e.g., I-123), or slug
Slug: 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

string
Initiative name, ID, identifier (e.g., I-123), or slug. If provided, updates the existing initiative
string
Icon name or emoji code (e.g. “Rocket” or “:eagle:”), not a raw Unicode emoji
string
Initiative name (required when creating)
string
Hex color
string
User ID, name, email, or “me”. Null to remove
array
Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field
array
Label names or IDs as a JSON array of strings (e.g. [“Bug”, “Urgent”]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged
string
Initiative status (Proposed, Planned, Active, Completed, Canceled)
string
Short summary (max 255 chars)
string
Lead team name, key, or ID. Null to remove the lead team
integer
0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
string
Target date (ISO format)
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
array
Parent initiatives to add. Initiative name, ID, identifier (e.g., I-123), or slug. Appended to existing parents
Slug: LINEAR_MCP_SAVE_INITIATIVE_LABELCreate or update a Linear initiative label. If id is provided, updates the existing label; otherwise creates a new one. When creating, name is required.

Input Parameters

string
Label name or ID. If provided, updates the existing label
string
Label name (required when creating)
string
Hex color code
string
Parent label group name or ID. Null to remove from its group
boolean
Whether the label is a group
string
Label description. Null to clear it
Slug: 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

string
Only for updating an existing issue. Pass the issue ID or identifier (e.g., LIN-123). Do NOT pass this parameter when creating a new issue.
string
Team name or ID (required when creating)
string
Cycle name, number, or ID. Null to remove
Link attachments to add [{url, title}]. Append-only; existing links are never removed
array
Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field
string
State type, name, or ID
string
Issue title (required when creating, unless template is set)
array
Issue IDs/identifiers this blocks. Append-only; existing relations are never removed
array
Label names or IDs as a JSON array of strings (e.g. [“Bug”, “Urgent”]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged. Cannot be combined with addLabels/removeLabels; prefer those for incremental changes
string
Due date (ISO format). On update, pass null to remove the due date
string
Project name, ID, identifier (e.g., P-ENG-123), or slug. Null to remove
string
SLA day counting type: “all” or “onlyBusinessDays”. Only use with slaBreachesAt; null means unset
string
User ID, name, email, or “me”. Null to remove
string
Agent name or ID. When the user asks to delegate to “Linear” or “the Linear agent”, this refers to the “Linear” app user specifically. Null to remove
string
Issue estimate value. On create, pass null or omit for no estimate. On update, pass null to clear the estimate; omitting leaves it unchanged. 0 is a real estimate only on teams that allow zero estimates.
string
Parent issue ID or identifier (e.g., LIN-123). Null to remove
number
0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
string
Template name or ID. Applied on create only. The template fills in the content, fields, and sub-issues server-side. A description replaces the template body rather than merging with it, but an empty description keeps the template body. Labels merge with the template’s own
array
Label names or IDs as a JSON array of strings (e.g. [“Bug”, “Urgent”]) to add. Append-only; existing labels are never removed. Cannot be combined with a team change
array
Issue IDs/identifiers blocking this. Append-only; existing relations are never removed
string
Milestone name or ID
Related issue IDs/identifiers. Append-only; existing relations are never removed
array
Release IDs or slugs to add. Append-only; existing releases are never removed
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
string
Duplicate of issue ID/identifier. Null to remove
array
Replace all releases on the issue with these. Cannot be combined with addReleases/removeReleases
array
Issue IDs/identifiers to stop blocking
array
Label names or IDs as a JSON array of strings (e.g. [“Bug”, “Urgent”]) to remove. Only valid when updating an existing issue. Cannot be combined with a team change
string
ISO-8601 timestamp when the SLA will breach. On update, pass null to remove the SLA
array
Release IDs or slugs to remove. Only valid when updating an existing issue
array
Issue IDs/identifiers to remove as blockers of this issue
Related issue IDs/identifiers to remove
Slug: 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

string
Label name or ID. If provided, updates the existing label
string
Label name (required when creating)
string
Hex color code
string
Parent label group name or ID. Null to remove from its group
string
Team UUID (omit for workspace label). When updating, only disambiguates id by name; a label’s team cannot be changed
boolean
Whether the label is a group
string
Label description. Null to clear it
Slug: LINEAR_MCP_SAVE_MILESTONECreate 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.

Input Parameters

string
Milestone name or ID
string
Milestone name (required when creating)
string
required
Project name, ID, identifier (e.g., P-ENG-123), or slug
string
Target completion date (ISO format, null to remove)
string
Milestone description
Slug: 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

string
Project name, ID, identifier (e.g., P-ENG-123), or slug. If provided, updates the existing project
string
Icon name or emoji code (e.g. “Rocket” or “:eagle:”), not a raw Unicode emoji
string
User ID, name, email, or “me”. Null to remove, except on create with a template that names a lead
string
Project name (required when creating)
string
Hex color
External resource links to add [{url, title}]. Append-only; existing links are never removed
array
Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field
string
Project state
array
Label names or IDs as a JSON array of strings (e.g. [“Bug”, “Urgent”]). Replaces the full label set; existing labels not included are removed. Omit to leave labels unchanged
string
Short summary (max 255 chars)
array
Team name or ID to add
integer
0=None, 1=Urgent, 2=High, 3=Medium, 4=Low
array
Replace all teams with these. Cannot combine with addTeams/removeTeams
string
Template name or ID. Applied on create only. The template fills in the content, fields, and sub-issues server-side. A description replaces the template body rather than merging with it, but an empty description keeps the template body. Labels merge with the template’s own
string
Start date (ISO format). Pair with startDateResolution to indicate precision (e.g. month, quarter)
string
Target date (ISO format). Pair with targetDateResolution to indicate precision (e.g. month, quarter)
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
array
Team name or ID to remove
array
Initiatives to add. Initiative name, ID, identifier (e.g., I-123), or slug
array
Replace all initiatives with these. Initiative name, ID, identifier (e.g., I-123), or slug. Cannot combine with addInitiatives/removeInitiatives
array
Initiatives to remove. Initiative name, ID, identifier (e.g., I-123), or slug
string ("halfYear" | "month" | "quarter" | "year")
Start date resolution
string ("halfYear" | "month" | "quarter" | "year")
Target date resolution
Slug: LINEAR_MCP_SAVE_PROJECT_LABELCreate or update a Linear project label. If id is provided, updates the existing label; otherwise creates a new one. When creating, name is required.

Input Parameters

string
Label name or ID. If provided, updates the existing label
string
Label name (required when creating)
string
Hex color code
string
Parent label group name or ID. Null to remove from its group
boolean
Whether the label is a group
string
Label description. Null to clear it
Slug: LINEAR_MCP_SAVE_RELEASECreate or update a release. If id is provided, updates the existing release; otherwise creates a new one. When creating, name and pipeline are required. Release status is modeled as the release pipeline stage.

Input Parameters

string
Release ID or slug to update. Omit to create a new release.
string
Release name (required when creating)
string
Release stage ID, exact name, or lifecycle type within the release pipeline
string
Version identifier
string
Release pipeline ID, slug, or exact name (required when creating)
string
Commit SHA associated with the release
string
Import/create timestamp (ISO DateTime)
string
Estimated start date (ISO YYYY-MM-DD, null to remove)
string
Started timestamp (ISO DateTime, null to remove)
string
Estimated completion date (ISO YYYY-MM-DD, null to remove)
string
Completed timestamp (ISO DateTime, null to remove)
string
Release description
Slug: 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

string
Release notes ID or slug to update. Omit to create new release notes.
array
Partial edits applied to the current content, in order and atomically (one failing operation aborts the whole save). Every anchor string must match the current content exactly once. Only valid on update, in place of the full content/description field
string
Release notes title
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
string
Release pipeline ID, slug, or exact name (required when creating)
array
Release IDs or slugs to include in the note
string
Newest release ID or slug in the note range
string
Oldest release ID or slug in the note range
Slug: LINEAR_MCP_SAVE_STATUS_UPDATECreate or update a project/initiative status update. Omit id to create, provide id to update.

Input Parameters

string
Status update ID - if provided, updates this existing update
string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. To mention a user, use @displayName (e.g., @johndoe)
string ("project" | "initiative")
required
Type of status update
string ("onTrack" | "atRisk" | "offTrack")
onTrack | atRisk | offTrack
string
Project name, ID, identifier (e.g., P-ENG-123), or slug
string
Initiative name, ID, identifier (e.g., I-123), or slug
boolean
Deprecated. Hide diff with previous update (create only)
Slug: LINEAR_MCP_SEARCH_DOCUMENTATIONSearch Linear’s documentation to learn about features and usage

Input Parameters

number
Page number
string
required
Search query
Slug: LINEAR_MCP_SHARE_ISSUEShare an issue with a workspace user who cannot otherwise access it. Use this tool only when the user explicitly asks to share the issue.

Input Parameters

string
required
User ID, name, email, or “me” Must be an email address or UUID.
string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues
Slug: LINEAR_MCP_SUBMIT_DIFF_REVIEWApprove a Linear diff, request changes, or submit a review comment

Input Parameters

string
Content as Markdown. Do not escape the string — use literal newlines and special characters, not escape sequences. Required when requesting changes or commenting
string
required
Linear review URL, diff slug, pull request ID, Linear full identifier, or GitHub PR URL
string ("approved" | "changesRequested" | "commented")
required
Review decision: approved, changesRequested, or commented
Slug: LINEAR_MCP_UNSHARE_ISSUERemove a workspace user’s shared access to an issue. Use this tool only when the user explicitly asks to stop sharing the issue.

Input Parameters

string
required
User ID, name, email, or “me” Must be an email address or UUID.
string
required
Issue ID or identifier (e.g., LIN-123). P-prefixed identifiers (e.g., P-ENG-123) are projects, not issues