Linear
Service domainPROJECT MANAGEMENT
Arcade Optimized
Arcade tools designed for LLMs to interact with Linear
42tools
Linear Toolkit
The Linear toolkit lets LLMs interact with Linear's project management platform via Arcade, covering the full lifecycle of issues, projects, initiatives, cycles, and team workflows.
Capabilities
- Issue management — create, update, archive, transition workflow states, manage labels, link GitHub PRs/commits/issues, subscribe to notifications, and model relationships between issues (blocks, duplicates, related).
- Projects & milestones — create, update, and archive projects; add status updates; upsert and retrieve milestones; fetch full paginated descriptions.
- Initiatives — create, update, archive, and list high-level strategic initiatives; link projects to initiatives; read paginated descriptions.
- Comments & threading — add, update, reply to, and list comments on both issues and project documents; note that API-created project comments appear in the comments panel only (not visually inline-anchored) — true inline anchoring requires the Linear UI.
- Cycles, teams & workflow states — list cycles (sprints) by team/status; inspect team details and workflow states; look up entities by ID, key, or fuzzy name.
- User & activity context — identify the authenticated user (
WhoAmI), retrieve recent issue activity, and fetch inbox notifications (mentions, assignments, state changes).
OAuth
This toolkit authenticates via OAuth 2.0 with Linear as the provider. See the Linear auth provider docs for setup details.
Available tools(42)
42 of 42 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 42)
Last updated on