Linear

Linear Toolkit

The Linear toolkit lets LLMs interact with the Linear project management platform through Arcade, covering the full lifecycle of issues, projects, initiatives, cycles, milestones, comments, and attachments.

Capabilities

Issue management: Create, update, archive, and transition issues through workflow states; manage labels, assignees, cycles, projects, and parent/child relationships; create and resolve comment threads, replies, and subscriptions.
Project & initiative management: Create, update, and archive projects and initiatives; manage project statuses (including custom statuses), milestones, progress updates, and links between projects and initiatives.
Cycles & workflow: List and filter cycles (time-boxed sprints) and workflow states; assign issues to cycles; transition issue states with team-specific state validation.
Comments & inline anchoring: Add, update, reply to, and resolve comments on issues and project documents; retrieve threaded comments with quoted-text metadata (note: API-created project comments appear in the comments panel, not visually anchored inline — true inline anchoring requires the Linear UI).
Attachments & assets: Attach or remove URLs and local files to issues, projects, and initiatives; read Linear-hosted asset bytes (images, text, PDFs up to 5 MiB each) as base64 data URIs; upsert without duplication for URL attachments.
Discovery & activity: List teams, labels, workflow states, project statuses, notifications, and recent activity; look up any entity by ID, key, slug, or fuzzy name; retrieve the authenticated user's profile and team memberships.

OAuth

This toolkit authenticates via OAuth 2.0 with Linear. See the Linear auth provider docs for setup details.

	Tool name	Description	Secrets
	Linear.AddComment	Add a comment to an issue.
	Linear.AddProjectComment	Add a comment to a project's document content. IMPORTANT: Due to Linear API limitations, comments created via the API will NOT appear visually anchored inline in the document (no yellow highlight on text). The comment will be stored and can be retrieved via list_project_comments, but it will appear in the comments panel rather than inline in the document. For true inline comments that are visually anchored to text, users should create them directly in the Linear UI by selecting text and adding a comment. The quoted_text parameter stores metadata about what text the comment references, which is useful for context even though the comment won't be visually anchored.
	Linear.AddProjectToInitiative	Link a project to an initiative. Both initiative and project can be specified by ID or name. If a name is provided, fuzzy matching is used to resolve it.
	Linear.ArchiveInitiative	Archive an initiative. Archived initiatives are hidden from default views but can be restored.
	Linear.ArchiveIssue	Archive an issue. Archived issues are hidden from default views but can be restored.
	Linear.ArchiveProject	Archive a project. Archived projects are hidden from default views but can be restored.
	Linear.CreateInitiative	Create a new Linear initiative. Initiatives are high-level strategic goals that group related projects.
	Linear.CreateIssue	Create a new Linear issue with validation. When assignee is None or '@me', the issue is assigned to the authenticated user. All entity references (team, assignee, labels, state, project, cycle, parent) are validated before creation. If an entity is not found, suggestions are returned to help correct the input.
	Linear.CreateIssueRelation	Create a relation between two issues. Relation types define the relationship from the source issue's perspective: - blocks: Source issue blocks the related issue - blockedBy: Source issue is blocked by the related issue - duplicate: Source issue is a duplicate of the related issue - related: Issues are related (bidirectional)
	Linear.CreateProject	Create a new Linear project. Team is validated before creation. If team is not found, suggestions are returned to help correct the input. Lead is validated if provided.
	Linear.CreateProjectStatus	Create a new project status in the Linear workspace. Requires Linear workspace admin access; without it the create fails. Status names are unique per category: the same name may exist once per type. When a status with the same name and type already exists, this returns a retryable error carrying the existing status's id so it can be reused instead of duplicated. A same-named status of a different type is allowed.
	Linear.CreateProjectUpdate	Create a project status update. Project updates are posts that communicate progress, blockers, or status changes to stakeholders. They appear in the project's Updates tab and can include a health status indicator.
	Linear.GetCycle	Get detailed information about a specific Linear cycle.
	Linear.GetInitiative	Get detailed information about a specific Linear initiative. Supports lookup by ID or name (with fuzzy matching for name).
	Linear.GetInitiativeDescription	Get an initiative's full description with pagination support. Use this tool when you need the complete description of an initiative that was truncated in the get_initiative response. Supports chunked reading for very large descriptions.
	Linear.GetIssue	Get detailed information about a specific Linear issue. Accepts either the issue UUID or the human-readable identifier (like TOO-123).
	Linear.GetMilestone	Get a milestone by ID or name inside a project.
	Linear.GetNotifications	Get the authenticated user's notifications. Returns notifications including issue mentions, comments, assignments, and state changes.
	Linear.GetProject	Get detailed information about a specific Linear project. Supports lookup by ID, slug_id, or name (with fuzzy matching for name).
	Linear.GetProjectDescription	Get a project's full description with pagination support. Use this tool when you need the complete description of a project that was truncated in the get_project response. Supports chunked reading for very large descriptions.
	Linear.GetRecentActivity	Get the authenticated user's recent issue activity. Returns issues the user has recently created or been assigned to within the specified time period.
	Linear.GetTeam	Get detailed information about a specific Linear team. Supports lookup by ID, key (like TOO, ENG), or name (with fuzzy matching).
	Linear.ListAvailableProjectStatuses	List the project statuses a project can be put in, in the Linear workspace. Includes custom statuses, not just the built-in categories, so the exact name, id, and type of each status can be discovered before filtering projects by status or assigning a status to a project. Returned in lifecycle order (backlog → planned → started → paused → completed → canceled), then by position within each category. Project statuses are a small workspace-level vocabulary and the whole set is returned in one call (no pagination).
	Linear.ListComments	List comments on an issue. Returns comments with user info, timestamps, and reply threading info.
	Linear.ListCycles	List Linear cycles, optionally filtered by team and status. Cycles are time-boxed iterations (like sprints) for organizing work.

Linear Toolkit

Capabilities

OAuth

Available tools(48)

Get Building