Skip to main content

Linear

A connector to the Linear project management platform.

What you can ask​

  • List every issue in the Platform team assigned to me, sorted by priority.
  • Create a Linear issue from each row in this triage doc and assign by area.
  • Find every issue closed in the last 7 days, grouped by project.

Set up​

Linear connects with credentials from your Linear account. Have these values ready:

  • API key
  1. Go to Organization > Connectors and find Linear.
  2. Click Enable and choose which tools to allow.
  3. Each member enters their own values the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

Tools​

Linear offers 76 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (31)​

View and search information without changing it.

ToolWhat it does
get_attachmentsList the links attached to a Linear issue, such as PRs, docs and dashboards. issue_id accepts a UUID or an identifier like 'ENG-142'.
get_commentGet a single Linear comment by id.
get_commentsList comments from Linear, optionally scoped to one issue via issue_id (accepts a UUID or an identifier like 'ENG-142'; use get_issues to find issues).
get_customerGet one Linear customer by id, with its status, tier, owner and need count.
get_customer_needGet one Linear customer need by id: its content, priority, source attachment url, customer and issue.
get_documentGet a single Linear document by id, including its full Markdown content.
get_documentsList documents from Linear.
get_initiativeGet one Linear initiative by id, including its full Markdown content.
get_issueGet a single Linear issue by id (UUID) or identifier like 'ENG-142'.
get_issue_labelsList issue labels from Linear, with server-side name (substring) and team_id filters plus cursor pagination.
get_issue_relationsList the relations on a Linear issue in BOTH directions: what it blocks, what blocks it, duplicates and related links.
get_issuesList issues from Linear with server-side filters (team, assignee, project, project milestone, state, priority, title text, label, updated-after date) and cursor pagination.
get_projectGet a single Linear project by id, including its full Markdown content.
get_project_milestoneGet one Linear project milestone by id (UUID): name, description, target date, status, and progress.
get_project_updateGet a single Linear project update by id.
get_project_updatesList project status updates from Linear, optionally scoped to one project via project_id (use get_projects to find project ids).
get_projectsList projects from Linear.
get_teamGet a single Linear team by id, including its members.
get_teamsList teams from Linear.
get_userGet a single Linear user by id.
get_usersList users in the Linear workspace.
list_customer_needsList Linear customer needs (customer requests linked to issues) with cursor pagination.
list_customer_statusesList the workspace's customer statuses (e.g. Active, Churned) with ids. Call this before create_customer or update_customer to get a valid status_id, or list_customers to filter by status.
list_customer_tiersList the workspace's customer tiers (e.g. Enterprise, SMB) with ids. Call this before create_customer or update_customer to get a valid tier_id, or list_customers to filter by tier.
list_customersList Linear customers (organizations that file requests) with cursor pagination.
list_cyclesList cycles (sprints) from Linear, filterable by team_id (use get_teams) and is_active.
list_initiativesList Linear initiatives (strategic goals that group projects) with cursor pagination.
list_issue_statusesList workflow states (issue statuses) from Linear, filterable by team_id (use get_teams) and state category.
list_project_milestonesList Linear project milestones (dated checkpoints inside a project) with cursor pagination.
list_project_statusesList the workspace-defined project statuses (e.g. Backlog, Planned, In Progress). Use this to find status ids for create_project/update_project's status_id; each status also shows its fixed type, which is what get_projects' state filter matches.
validate_credentialValidate Linear credentials by fetching the authenticated user.

Write (12)​

Create or send data.

ToolWhat it does
create_commentAdd a comment to a Linear issue. issue_id accepts a UUID or an identifier like 'ENG-142'; use get_issues to find issues.
create_customerCreate a Linear customer.
create_customer_needCreate a Linear customer need: record that a customer wants something on an issue.
create_documentCreate a Linear document.
create_initiativeCreate a Linear initiative.
create_issueCreate a Linear issue.
create_issue_labelCreate a Linear issue label.
create_issue_relationLink two Linear issues, e.g. mark one as blocking another or as a duplicate.
create_projectCreate a Linear project.
create_project_milestoneCreate a Linear project milestone (a dated checkpoint inside a project).
create_project_updatePost a status update on a Linear project.
create_teamCreate a Linear team.

Delete or overwrite (33)​

Remove or replace existing data.

ToolWhat it does
archive_initiativeArchive a Linear initiative by id.
archive_issueArchive a Linear issue by id or identifier like 'ENG-142'.
archive_projectArchive a Linear project by id.
archive_project_updateArchive a Linear project update by id.
create_attachmentAttach a link to a Linear issue, e.g. a PR, doc or dashboard. issue_id accepts a UUID or an identifier like 'ENG-142'.
delete_attachmentDelete a link attached to a Linear issue, the inverse of create_attachment.
delete_commentDelete a Linear comment by id (permanent).
delete_customerDelete a Linear customer by id, the inverse of create_customer.
delete_customer_needDelete a Linear customer need by id, the inverse of create_customer_need.
delete_documentDelete a Linear document by id (moves it to the trash, Linear's delete).
delete_issueDelete a Linear issue by id or identifier like 'ENG-142'.
delete_issue_labelDelete a Linear issue label by id (permanent), the inverse of create_issue_label.
delete_issue_relationRemove a link between two Linear issues.
delete_project_milestoneDelete a Linear project milestone by id, the inverse of create_project_milestone.
resolve_commentResolve a Linear comment thread by comment id.
restore_documentRestore a trashed Linear document by id, the inverse of delete_document.
unarchive_initiativeRestore an archived Linear initiative by id, the inverse of archive_initiative.
unarchive_issueRestore an archived or soft-deleted Linear issue by id or identifier like 'ENG-142'.
unarchive_projectRestore an archived Linear project by id, the inverse of archive_project.
unarchive_project_updateRestore an archived Linear project update by id.
unresolve_commentReopen a resolved Linear comment thread by comment id.
update_commentEdit the body of an existing Linear comment.
update_customerUpdate a Linear customer by id (list_customers): name, domains (replaces list), external_ids (adds), owner, revenue, size, status_id, tier_id, Slack channel.
update_customer_needUpdate a Linear customer need by id (list_customer_needs): reassign customer_id, move to another issue_id, body, priority 0/1, attachment_url.
update_cycleUpdate a Linear cycle (sprint): name, description, starts_at, ends_at, or completed_at.
update_documentUpdate a Linear document by id: title, content (Markdown body), icon, color, or its project/issue association.
update_initiativeUpdate a Linear initiative by id (list_initiatives): name, description, content, status, priority, owner, lead team, target date, color, icon.
update_issueUpdate a Linear issue by id or identifier like 'ENG-142': title, description, priority 0-4, estimate, assignee_id (get_users), state_id (list_issue_statuses), labels (get_issue_labels), project/cycle/project_milestone/parent, subscriber_ids, due_date, team transfer.
update_issue_labelEdit a Linear issue label: rename it, change its color or description, or nest it under a group label (parent_id) or remove it from its group (unset_parent=true).
update_projectUpdate a Linear project by id: name, description, content (Markdown body), lead, status, priority, teams, or dates.
update_project_milestoneUpdate a Linear project milestone: name, description, target_date, or move it to another project (project_id).
update_project_updateEdit an existing Linear project update's body or health by id.
update_teamUpdate a Linear team's name, key, or description by team id.
⌘J