47 available actions

What your AI agent can do in Linear

Linear is a streamlined issue tracking and project planning tool for modern teams, featuring fast workflows, keyboard shortcuts, and GitHub integrations This page lists every available action. Your agent only receives the actions and permissions required for the role you approve.

Common starting points

Get create issue default paramsFetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms.
Get Project UpdateRetrieves a specific project update by its unique identifier.
Add reaction to commentTool to add a reaction to an existing Linear comment.
Create a commentCreates a new comment on a specified Linear issue.
Archive Project UpdateArchives a project update in Linear, hiding it from the default view while preserving its data.
Update issueUpdates an existing Linear issue using its ; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.)…

Browse all 47 actions by capability

Open a capability to see every supported action and its description.

Find & reviewLook up and review existing recordsView 21 actionsHide actions

Get all teams (Deprecated)DEPRECATED: Use ListLinearTeams instead (returns paginated payloads with members and projects); this tool returns simpler id/name-level data for all teams visible to…
Download issue filesDownloads a Linear Attachment record or a private upload embedded in issue/comment Markdown; must include the correct extension.
Get a commentRetrieves a single Linear comment by its unique ID.
Get current userGets the currently authenticated user's ID, name, email, and other profile information — this is the account behind the API token, which may be a bot or service account…
Get cycles by team IDRetrieves all cycles for a specified Linear team ID; cycles are time-boxed work periods (like sprints).
Get create issue default paramsFetches a Linear team's default issue estimate and state, useful for pre-filling new issue forms.
Get Linear issueRetrieves an existing Linear issue's comprehensive details, including id, identifier, title, description, timestamps, state, team, creator, attachments, comments (with…
Get Linear projectRetrieves a single Linear project by its unique identifier.
Get Project UpdateRetrieves a specific project update by its unique identifier.
List commentsLists comments from Linear workspace accessible to the authenticated user.
List issue draftsTool to list issue drafts.
List issues by team IDTool to list all issues for a specific Linear team, scoped by team ID.
Get all cyclesRetrieves all cycles (time-boxed sprint iterations) org-wide from the Linear account; no filters applied.
List Linear issuesLists non-archived Linear issues; if project_id is not specified, issues from all accessible projects are returned.
Get labelsRetrieves labels from Linear.
List linear projectsRetrieves all projects from the Linear account.
List Linear statesRetrieves all workflow states for a specified team in Linear, representing the stages an issue progresses through in that team's workflow.
Get teamsRetrieves all teams with their members and projects.
List Linear usersLists all workspace users (not team-scoped) with their IDs, names, emails, and active status.
List project updatesRetrieves all project updates from the Linear workspace.
Search Linear issuesSearch Linear issues using full-text search across identifier, title, and description.

Create & communicateCreate records or send supported messagesView 10 actionsHide actions

Create attachmentCreates a new attachment and associates it with a specific, existing Linear issue.
Add reaction to commentTool to add a reaction to an existing Linear comment.
Create a commentCreates a new comment on a specified Linear issue.
Create linear issueCreates a new issue in a specified Linear project and team, requiring team_id and title, and allowing optional properties like description, assignee, state, priority…
Create issue relationCreate a relationship between two Linear issues using the issueRelationCreate mutation.
Create a labelCreates a new label in Linear for a specified team, used to categorize and organize issues.
Create ProjectCreates a new Linear project with specified name and team associations.
Create Project MilestoneTool to create a project milestone in Linear with a name and optional target date and sort order.
Create Project UpdateTool to create a project status update post for a Linear project.
Create TeamCreates a new team in Linear with the specified name and key.

Update & manageChange and manage existing recordsView 9 actionsHide actions

Archive issueArchives an existing Linear issue by its ID, removing it from active views while preserving its data for future reference.
Archive ProjectArchives an existing Linear project by its UUID, removing it from active views.
Archive Project UpdateArchives a project update in Linear, hiding it from the default view while preserving its data.
Run Query or MutationExecute any GraphQL query or mutation against Linear's API.
Update issueUpdates an existing Linear issue using its ; requires at least one other attribute for modification, and all provided entity IDs (for state, assignee, labels, etc.)…
Update a commentTool to update an existing Linear comment's body text.
Update ProjectTool to update an existing Linear project.
Update Project UpdateTool to update an existing Linear project update post.
Update TeamUpdates an existing Linear team's settings and configuration.

Remove & cancelRemove records or cancel supported workView 3 actionsHide actions

Delete issueArchives an existing Linear issue by its ID, which is Linear's standard way of deleting issues; the operation is idempotent.
Remove label from Linear issueRemoves a specified label from an existing Linear issue using their IDs; successful even if the label isn't on the issue.
Remove reaction from commentTool to remove a reaction on a comment.

Other actionsSpecialist and administrative actions.View 4 actionsHide actions

Resolve commentMarks a Linear comment as resolved.
Unarchive Project UpdateUnarchive a previously archived project update in Linear.
Unresolve a commentUnresolves a previously resolved Linear comment, marking it as requiring attention again.
Validate credentialValidates the Linear API credentials by checking if the authentication token can successfully query the current user.

Connection record

A connection you can control.

Sign-in: OAuth sign-in
Setup: Sign in with your own Linear account. Access is limited to the work agreed for the role.
Boundaries: Only the approved role and actions.
Off switch: Revoke the connection from your account.

FAQ

Before you connect Linear

How does the agent connect to Linear?

You sign in with your own Linear account. Permissions are limited to what the agent needs, the connection is health-checked, and you can revoke access from Linear at any time.

What can the agent actually do in Linear?

The page above lists the 47 actions currently available through the Linear connection. The role determines which of those actions the agent may use, and write access is only enabled when the workflow needs it.

Is Linear included in my plan?

Connections are priced per tool on top of the base plan. Some are included and some are premium. See pricing for how connection charges work.

How long until Linear is ready?

Timing depends on the sign-in method, permissions and workflow being connected. We confirm the scope and setup plan before enabling the connection.

Bring the workflow together

Ready to put Linear to work?

Start with the responsibility you want off your plate. We’ll map the connection and the boundaries around it.

Book a setup call Browse all connections

All product names, logos, and brands are property of their respective owners and are used for identification only. ZeroToClaw is not affiliated with or endorsed by Linear.