Linear
Service domainPROJECT MANAGEMENT
Arcade Optimized
Arcade tools designed for LLMs to interact with Linear
44tools
The Linear toolkit lets LLMs interact with Linear, Atlassian's project management platform, via Arcade. It covers the full project management lifecycle: issues, projects, initiatives, cycles, milestones, comments, and notifications.
Capabilities
- Issue management — create, update, archive, transition workflow states, manage relations (blocks/blocked-by/duplicate/related), link GitHub PRs/commits, subscribe to notifications, and add or resolve comment threads.
- Project & milestone management — create, update, and archive projects; read full paginated descriptions; manage milestones via upsert; post and list project status updates.
- Initiatives & cycles — create, update, archive, and link projects to strategic initiatives; list and inspect time-boxed cycles/sprints with team and status filters.
- Comments & threads — add, reply to, update, resolve/reopen, and list comments on both issues and project documents, including inline-quoted comments (with API-level anchoring caveats noted).
- Discovery & listing — list and fuzzy-search teams, issues, projects, initiatives, cycles, milestones, labels, workflow states, project updates, and comments, all with optional keyword filters.
- User & workspace context — retrieve the authenticated user's profile, team memberships, notifications, and recent activity.
OAuth
This toolkit authenticates via OAuth 2.0 with Linear as the provider. See the Arcade Linear auth provider docs for setup details.
Available tools(44)
44 of 44 tools
Operations
Behavior
| Tool name | Description | Secrets | |
|---|---|---|---|
Add a comment to an issue. | |||
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. | |||
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. | |||
Archive an initiative.
Archived initiatives are hidden from default views but can be restored. | |||
Archive an issue.
Archived issues are hidden from default views but can be restored. | |||
Archive a project.
Archived projects are hidden from default views but can be restored. | |||
Create a new Linear initiative.
Initiatives are high-level strategic goals that group related projects. | |||
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. | |||
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) | |||
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. | |||
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. | |||
Get detailed information about a specific Linear cycle. | |||
Get detailed information about a specific Linear initiative.
Supports lookup by ID or name (with fuzzy matching for name). | |||
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. | |||
Get detailed information about a specific Linear issue.
Accepts either the issue UUID or the human-readable identifier (like TOO-123). | |||
Get a milestone by ID or name inside a project. | |||
Get the authenticated user's notifications.
Returns notifications including issue mentions, comments, assignments,
and state changes. | |||
Get detailed information about a specific Linear project.
Supports lookup by ID, slug_id, or name (with fuzzy matching for name). | |||
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. | |||
Get the authenticated user's recent issue activity.
Returns issues the user has recently created or been assigned to
within the specified time period. | |||
Get detailed information about a specific Linear team.
Supports lookup by ID, key (like TOO, ENG), or name (with fuzzy matching). | |||
Link a GitHub PR, commit, or issue to a Linear issue.
Automatically detects the artifact type from the URL and generates
an appropriate title if not provided. | |||
List comments on an issue.
Returns comments with user info, timestamps, and reply threading info. | |||
List Linear cycles, optionally filtered by team and status.
Cycles are time-boxed iterations (like sprints) for organizing work. | |||
List Linear initiatives, optionally filtered by keywords and other criteria.
Returns all initiatives when no filters provided, or filtered results when
keywords or other filters are specified. |
Page 1 of 2(25 of 44)
Last updated on