Linear

Description: Enable agents to interact with Linear

Author: Arcade

Code: GitHub

Auth: User authorization

PyPI VersionLicensePython VersionsWheel StatusDownloads

The Linear toolkit offers a streamlined set of tools for interacting with Linear’s issue tracking and team management features. With this toolkit, users can:

  • Retrieve detailed information about a specific issue, including their status, comments, and related dependencies.
  • Access comprehensive team information, including team members, roles, and settings.

This toolkit is ideal for users looking to read and analyze issue and team data within Linear without making any modifications.

Available Tools

Tool NameDescription
Linear.GetIssueGet detailed information about a specific Linear issue
Linear.GetTeamsGet Linear teams and team information including team members

If you need to perform an action that’s not listed here, you can get in touch with us to request a new tool, or create your own tools.

Linear.GetIssue


Get detailed information about a specific Linear issue

Parameters

  • issue_id (string, required) The Linear issue ID or identifier (e.g. ‘FE-123’, ‘API-456’) to retrieve.
  • include_comments (boolean, optional) Whether to include comments in the response. Defaults to True.
  • include_attachments (boolean, optional) Whether to include attachments in the response. Defaults to True.
  • include_relations (boolean, optional) Whether to include issue relations (blocks, dependencies) in the response. Defaults to True.
  • include_children (boolean, optional) Whether to include sub-issues in the response. Defaults to True.

Linear.GetTeams


Get Linear teams and team information including team members

Parameters

  • team_name (string, optional) Filter by team name. Provide specific team name (e.g. ‘Frontend’, ‘Product Web’) or partial name. Use this to find specific teams or check team membership. Defaults to None (all teams).
  • include_archived (boolean, optional) Whether to include archived teams in results. Defaults to False.
  • created_after (string, optional) Filter teams created after this date. Can be:
  • Relative date string (e.g. ‘last month’, ‘this week’, ‘yesterday’)
  • ISO date string (e.g. ‘YYYY-MM-DD’) Defaults to None (all time).
  • limit (integer, optional) Maximum number of teams to return. Min 1, max 100. Defaults to 50.
  • end_cursor (string, optional) Cursor for pagination - get teams after this cursor. Use the ‘end_cursor’ from previous response. Defaults to None (start from beginning).

Auth

The Arcade Linear toolkit uses the Linear auth provider to connect to users’ Linear accounts. Please refer to the Linear auth provider documentation to learn how to configure auth.