linear

Server path: /linear | Type: Application | PCID required: Yes Issues, projects, and cycles

Tools

Tool	Description
`linear_get_current_user`	Get information about the authenticated user
`linear_get_issues`	Retrieve a list of issues with optional filtering
`linear_get_issue_by_id`	Retrieve a specific issue by its ID
`linear_create_issue`	Create a new issue in Linear
`linear_update_issue`	Update an existing issue
`linear_delete_issue`	Delete an existing issue
`linear_get_teams`	Retrieve a list of teams
`linear_get_team_issues`	Retrieve issues for a specific team
`linear_get_projects`	Retrieve a list of projects
`linear_get_workflow_states`	Retrieve workflow states for teams
`linear_create_comment`	Add a comment to an issue
`linear_get_labels`	Retrieve labels for filtering and organization
`linear_create_label`	Create a new label for organizing issues
`linear_get_users`	Retrieve team members for assignment
`linear_create_attachment`	Create an attachment (link) for an existing issue. The URL acts as an idempotent identifier - creating the same URL on the same issue will update the existing attachment.
`linear_get_attachment_by_id`	Retrieve an attachment by its ID, including the associated issue information
`linear_get_attachments_by_url`	Retrieve all attachments with a specific URL. Useful for finding attachments and their associated issues by URL.
`linear_download_file`	Download a file from Linear’s authenticated storage (uploads.linear.app). Use this to download images embedded in issue descriptions. The image URLs are found in markdown format like in issue description fields. By default returns a downloadUrl for streaming. Set stream=false for small files (<2MB) to get immediate base64 content.
`linear_list_trigger_capabilities`	List available trigger types that can be created for Linear webhooks
`linear_create_trigger`	Create a Linear webhook that will send events
`linear_update_trigger`	Update an existing Linear webhook (can update label and event types)
`linear_delete_trigger`	Delete a Linear webhook

linear_get_current_user

Get information about the authenticated user

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_get_issues

Retrieve a list of issues with optional filtering Parameters:

Parameter	Type	Required	Default	Description
`filter`	object	No	—	Optional filter object for issues

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "filter": {
      "type": "object",
      "additionalProperties": true,
      "description": "Optional filter object for issues"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_get_issue_by_id

Retrieve a specific issue by its ID Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Issue ID to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "id": {
      "type": "string",
      "description": "Issue ID to retrieve"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

linear_create_issue

Create a new issue in Linear Parameters:

Parameter	Type	Required	Default	Description
`title`	string	Yes	—	Issue title
`description`	string	No	—	Issue description
`teamId`	string	Yes	—	Team ID where the issue will be created. Tip: Use linear_get_teams to discover available teams.
`projectId`	string	No	—	Project ID to associate the issue with. Tip: Use linear_get_projects to discover available projects.
`priority`	number	No	—	Priority level (1-4)
`assigneeId`	string	No	—	User ID to assign the issue to. Tip: Use linear_get_users to find available users.
`labelIds`	string[]	No	—	Array of label IDs to apply. Tip: Use linear_get_labels to discover available labels.
`stateId`	string	No	—	Workflow state ID. Tip: Use linear_get_workflow_states to find available states for the team.
`estimate`	number	No	—	Estimate in story points

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "title": {
      "type": "string",
      "description": "Issue title"
    },
    "description": {
      "type": "string",
      "description": "Issue description"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID where the issue will be created. Tip: Use linear_get_teams to discover available teams."
    },
    "projectId": {
      "type": "string",
      "description": "Project ID to associate the issue with. Tip: Use linear_get_projects to discover available projects."
    },
    "priority": {
      "type": "number",
      "description": "Priority level (1-4)"
    },
    "assigneeId": {
      "type": "string",
      "description": "User ID to assign the issue to. Tip: Use linear_get_users to find available users."
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of label IDs to apply. Tip: Use linear_get_labels to discover available labels."
    },
    "stateId": {
      "type": "string",
      "description": "Workflow state ID. Tip: Use linear_get_workflow_states to find available states for the team."
    },
    "estimate": {
      "type": "number",
      "description": "Estimate in story points"
    }
  },
  "required": [
    "PCID",
    "title",
    "teamId"
  ]
}

linear_update_issue

Update an existing issue Parameters:

Parameter	Type	Required	Default	Description
`issueId`	string	Yes	—	Issue ID to update
`title`	string	No	—	New issue title
`description`	string	No	—	New issue description
`priority`	number	No	—	New priority level (1-4)
`stateId`	string	No	—	New workflow state ID. Tip: Use linear_get_workflow_states to find available states.
`assigneeId`	string	No	—	New assignee user ID. Tip: Use linear_get_users to find available users.
`labelIds`	string[]	No	—	New array of label IDs. Tip: Use linear_get_labels to discover available labels.
`estimate`	number	No	—	New estimate in story points
`projectId`	string	No	—	Project ID to add the issue to. Tip: Use linear_get_projects to find available projects.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID to update"
    },
    "title": {
      "type": "string",
      "description": "New issue title"
    },
    "description": {
      "type": "string",
      "description": "New issue description"
    },
    "priority": {
      "type": "number",
      "description": "New priority level (1-4)"
    },
    "stateId": {
      "type": "string",
      "description": "New workflow state ID. Tip: Use linear_get_workflow_states to find available states."
    },
    "assigneeId": {
      "type": "string",
      "description": "New assignee user ID. Tip: Use linear_get_users to find available users."
    },
    "labelIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "New array of label IDs. Tip: Use linear_get_labels to discover available labels."
    },
    "estimate": {
      "type": "number",
      "description": "New estimate in story points"
    },
    "projectId": {
      "type": "string",
      "description": "Project ID to add the issue to. Tip: Use linear_get_projects to find available projects."
    }
  },
  "required": [
    "PCID",
    "issueId"
  ]
}

linear_delete_issue

Delete an existing issue Parameters:

Parameter	Type	Required	Default	Description
`issueId`	string	Yes	—	Issue ID to delete

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID to delete"
    }
  },
  "required": [
    "PCID",
    "issueId"
  ]
}

linear_get_teams

Retrieve a list of teams

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_get_team_issues

Retrieve issues for a specific team Parameters:

Parameter	Type	Required	Default	Description
`teamId`	string	Yes	—	Team ID to get issues for

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID to get issues for"
    }
  },
  "required": [
    "PCID",
    "teamId"
  ]
}

linear_get_projects

Retrieve a list of projects

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_get_workflow_states

Retrieve workflow states for teams

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_create_comment

Add a comment to an issue Parameters:

Parameter	Type	Required	Default	Description
`body`	string	Yes	—	Comment text
`issueId`	string	Yes	—	Issue ID to comment on

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "body": {
      "type": "string",
      "description": "Comment text"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID to comment on"
    }
  },
  "required": [
    "PCID",
    "body",
    "issueId"
  ]
}

linear_get_labels

Retrieve labels for filtering and organization

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_create_label

Create a new label for organizing issues Parameters:

Parameter	Type	Required	Default	Description
`name`	string	Yes	—	Label name
`color`	string	No	—	Label color as hex code (e.g., “#ff0000”). If not provided, Linear will assign a default color.
`description`	string	No	—	Label description
`teamId`	string	No	—	Team ID to scope the label to a specific team. If not provided, creates a workspace-level label. Tip: Use linear_get_teams to find team IDs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "name": {
      "type": "string",
      "description": "Label name"
    },
    "color": {
      "type": "string",
      "description": "Label color as hex code (e.g., \"#ff0000\"). If not provided, Linear will assign a default color."
    },
    "description": {
      "type": "string",
      "description": "Label description"
    },
    "teamId": {
      "type": "string",
      "description": "Team ID to scope the label to a specific team. If not provided, creates a workspace-level label. Tip: Use linear_get_teams to find team IDs."
    }
  },
  "required": [
    "PCID",
    "name"
  ]
}

linear_get_users

Retrieve team members for assignment

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    }
  },
  "required": [
    "PCID"
  ]
}

linear_create_attachment

Create an attachment (link) for an existing issue. The URL acts as an idempotent identifier - creating the same URL on the same issue will update the existing attachment. Parameters:

Parameter	Type	Required	Default	Description
`issueId`	string	Yes	—	Issue ID to attach the link to
`url`	string	Yes	—	URL of the link to attach (acts as idempotent identifier)
`title`	string	No	—	Title for the attachment
`subtitle`	string	No	—	Subtitle for the attachment
`iconUrl`	string	No	—	Icon URL for the attachment (must be png or jpg format)
`metadata`	object	No	—	Key-value metadata to store with the attachment

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "issueId": {
      "type": "string",
      "description": "Issue ID to attach the link to"
    },
    "url": {
      "type": "string",
      "description": "URL of the link to attach (acts as idempotent identifier)"
    },
    "title": {
      "type": "string",
      "description": "Title for the attachment"
    },
    "subtitle": {
      "type": "string",
      "description": "Subtitle for the attachment"
    },
    "iconUrl": {
      "type": "string",
      "description": "Icon URL for the attachment (must be png or jpg format)"
    },
    "metadata": {
      "type": "object",
      "additionalProperties": true,
      "description": "Key-value metadata to store with the attachment"
    }
  },
  "required": [
    "PCID",
    "issueId",
    "url"
  ]
}

linear_get_attachment_by_id

Retrieve an attachment by its ID, including the associated issue information Parameters:

Parameter	Type	Required	Default	Description
`id`	string	Yes	—	Attachment ID to retrieve

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "id": {
      "type": "string",
      "description": "Attachment ID to retrieve"
    }
  },
  "required": [
    "PCID",
    "id"
  ]
}

linear_get_attachments_by_url

Retrieve all attachments with a specific URL. Useful for finding attachments and their associated issues by URL. Parameters:

Parameter	Type	Required	Default	Description
`url`	string	Yes	—	URL to search for attachments

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "url": {
      "type": "string",
      "description": "URL to search for attachments"
    }
  },
  "required": [
    "PCID",
    "url"
  ]
}

linear_download_file

Download a file from Linear’s authenticated storage (uploads.linear.app). Use this to download images embedded in issue descriptions. The image URLs are found in markdown format like name

in issue description fields. By default returns a downloadUrl for streaming. Set stream=false for small files (<2MB) to get immediate base64 content. Parameters:

Parameter	Type	Required	Default	Description
`url`	string	Yes	—	The full URL to download (must be an https://uploads.linear.app/ URL). Found in issue descriptions as markdown image references.
`stream`	boolean	No	`true`	RECOMMENDED: true (default). Returns downloadUrl + auth headers for streaming. Set to false only for small files (<2MB) requiring immediate base64 content.
`extractText`	boolean	No	`true`	Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Set to false to skip extraction.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "url": {
      "type": "string",
      "description": "The full URL to download (must be an https://uploads.linear.app/ URL). Found in issue descriptions as markdown image references."
    },
    "stream": {
      "type": "boolean",
      "default": true,
      "description": "RECOMMENDED: true (default). Returns downloadUrl + auth headers for streaming. Set to false only for small files (<2MB) requiring immediate base64 content."
    },
    "extractText": {
      "type": "boolean",
      "default": true,
      "description": "Automatically extracts text from supported formats (PDF, DOCX, PPTX, XLSX) and includes it in the response. Set to false to skip extraction."
    }
  },
  "required": [
    "PCID",
    "url"
  ]
}

linear_list_trigger_capabilities

List available trigger types that can be created for Linear webhooks

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID (optional for this operation)"
    }
  }
}

linear_create_trigger

Create a Linear webhook that will send events Parameters:

Parameter	Type	Required	Default	Description
`triggerType`	string	Yes	—	Type of trigger to create
`webhookUrl`	string	Yes	—	The webhook URL where Linear should send events
`label`	string	Yes	—	Label/name for the Linear webhook
`resourceTypes`	any	Yes	—	Event types to subscribe to. Supports multiple formats: PascalCase (IssueLabel), lowercase (issuelabel), kebab-case (issue-label), or snake_case (issue_label). Common types: Issue, Comment, Project, IssueLabel, WorkflowState. Duplicates are automatically removed. Can be passed as JSON string array or array.
`filter`	any	Yes	—	Optional filter for events. Can include teamId (e.g., {“teamId”: “team-id”}) to limit webhook to a specific team. If not provided, webhook will listen to all public teams. Tip: Use linear_get_teams to discover available team IDs.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "triggerType": {
      "type": "string",
      "enum": [
        "linear_issue_events"
      ],
      "description": "Type of trigger to create"
    },
    "webhookUrl": {
      "type": "string",
      "description": "The webhook URL where Linear should send events"
    },
    "label": {
      "type": "string",
      "description": "Label/name for the Linear webhook"
    },
    "resourceTypes": {
      "type": "effects",
      "description": "Event types to subscribe to. Supports multiple formats: PascalCase (IssueLabel), lowercase (issuelabel), kebab-case (issue-label), or snake_case (issue_label). Common types: Issue, Comment, Project, IssueLabel, WorkflowState. Duplicates are automatically removed. Can be passed as JSON string array or array."
    },
    "filter": {
      "type": "effects",
      "description": "Optional filter for events. Can include teamId (e.g., {\"teamId\": \"team-id\"}) to limit webhook to a specific team. If not provided, webhook will listen to all public teams. Tip: Use linear_get_teams to discover available team IDs."
    }
  },
  "required": [
    "PCID",
    "triggerType",
    "webhookUrl",
    "label",
    "resourceTypes",
    "filter"
  ]
}

linear_update_trigger

Update an existing Linear webhook (can update label and event types) Parameters:

Parameter	Type	Required	Default	Description
`webhookId`	string	Yes	—	The ID of the webhook to update
`label`	string	No	—	New label for the webhook
`resourceTypes`	any	Yes	—	New event types to subscribe to. Supports multiple formats: PascalCase (IssueLabel), lowercase (issuelabel), kebab-case (issue-label), or snake_case (issue_label). Duplicates are automatically removed. Can be passed as JSON string array or array.

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "webhookId": {
      "type": "string",
      "description": "The ID of the webhook to update"
    },
    "label": {
      "type": "string",
      "description": "New label for the webhook"
    },
    "resourceTypes": {
      "type": "effects",
      "description": "New event types to subscribe to. Supports multiple formats: PascalCase (IssueLabel), lowercase (issuelabel), kebab-case (issue-label), or snake_case (issue_label). Duplicates are automatically removed. Can be passed as JSON string array or array."
    }
  },
  "required": [
    "PCID",
    "webhookId",
    "resourceTypes"
  ]
}

linear_delete_trigger

Delete a Linear webhook Parameters:

Parameter	Type	Required	Default	Description
`triggerId`	string	Yes	—	The ID of the webhook to delete
`webhookId`	string	No	—	Optional webhook ID to delete (if not provided, will be retrieved from metadata)

Show inputSchema

{
  "type": "object",
  "properties": {
    "PCID": {
      "type": "string",
      "description": "Pink Connect ID"
    },
    "triggerId": {
      "type": "string",
      "description": "The ID of the webhook to delete"
    },
    "webhookId": {
      "type": "string",
      "description": "Optional webhook ID to delete (if not provided, will be retrieved from metadata)"
    }
  },
  "required": [
    "PCID",
    "triggerId"
  ]
}

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

Tools

linear_get_current_user

linear_get_issues

linear_get_issue_by_id

linear_create_issue

linear_update_issue

linear_delete_issue

linear_get_teams

linear_get_team_issues

linear_get_projects

linear_get_workflow_states

linear_create_comment

linear_get_labels

linear_create_label

linear_get_users

linear_create_attachment

linear_get_attachment_by_id

linear_get_attachments_by_url

linear_download_file

linear_list_trigger_capabilities

linear_create_trigger

linear_update_trigger

linear_delete_trigger

Triggers API

Platform API

Embedded MCP Servers

Application MCP Servers

​Tools

​linear_get_current_user

​linear_get_issues

​linear_get_issue_by_id

​linear_create_issue

​linear_update_issue

​linear_delete_issue

​linear_get_teams

​linear_get_team_issues

​linear_get_projects

​linear_get_workflow_states

​linear_create_comment

​linear_get_labels

​linear_create_label

​linear_get_users

​linear_create_attachment

​linear_get_attachment_by_id

​linear_get_attachments_by_url

​linear_download_file

​linear_list_trigger_capabilities

​linear_create_trigger

​linear_update_trigger

​linear_delete_trigger

Tools

linear_get_current_user

linear_get_issues

linear_get_issue_by_id

linear_create_issue

linear_update_issue

linear_delete_issue

linear_get_teams

linear_get_team_issues

linear_get_projects

linear_get_workflow_states

linear_create_comment

linear_get_labels

linear_create_label

linear_get_users

linear_create_attachment

linear_get_attachment_by_id

linear_get_attachments_by_url

linear_download_file

linear_list_trigger_capabilities

linear_create_trigger

linear_update_trigger

linear_delete_trigger