Linear Tools Documentation

This document lists all available Linear tools and their usage.

Tools

Tool Name	Description	Parameters
linear_create_issue	Create a new issue in Linear	- title (string): The issue title - description (string, optional): The issue description as Markdown - team (string): The team ID - cycle (string, optional): The cycle ID to add the issue to - priority (number, optional): The issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low. Do not set this field unless explicitly requested. - project (string, optional): The project ID to add the issue to - state (string, optional): The issue state ID - assignee (string, optional): The assignee user ID to assign - delegate (string, optional): The delegate user ID - labels (array[string], optional): Array of label IDs to set on the issue - dueDate (string, optional): The due date for the issue in ISO format - parentId (string, optional): The parent issue ID, if this is a sub-issue - links (array[object], optional): Array of link objects to attach to the issue. Each object must contain a valid url and a non-empty title.
linear_get_issue	Get details of a specific issue by ID or identifier	- id (string): Issue ID or identifier (e.g., ENG-123)
linear_list_issues	List issues with filtering and pagination	- limit (number, optional): The number of results to return (Max is 250) - before (string, optional): An ID to end at - after (string, optional): An ID to start from - orderBy (enum["createdAt", "updatedAt"], optional): The order in which to return results - query (string, optional): Search for content in the issue title or description - team (string, optional): The team ID to filter by - state (string, optional): The state ID to filter by - cycle (string, optional): The cycle ID to filter by - label (string, optional): A label ID to filter by - assignee (string, optional): The assignee user ID to filter by - delegate (string, optional): The delegate user ID to filter by - project (string, optional): The project ID to filter by - parentId (string, optional): The parent issue ID to filter by - createdAt (string, optional): Return only issues created on or after this ISO-8601 date-time or duration. e.g. -P1D to get issues created in the last day - updatedAt (string, optional): Return only issues updated on or after this ISO-8601 date-time or duration. e.g. -P1D to get issues updated in the last day - includeArchived (boolean, optional): Whether to include archived issues
linear_update_issue	Update an existing issue	- id (string): The issue ID - title (string, optional): The issue title - description (string, optional): The issue description as Markdown - priority (number, optional): The issue priority. 0 = No priority, 1 = Urgent, 2 = High, 3 = Normal, 4 = Low. Do not set this field unless explicitly requested. - project (string, optional): The project ID to add the issue to - state (string, optional): The issue state ID - cycle (string, optional): The cycle ID - assignee (string, optional): The assignee user ID to assign - delegate (string, optional): The delegate user ID - labels (array[string], optional): Array of label IDs to set on the issue - parentId (string, optional): The parent issue ID, if this is a sub-issue - dueDate (string, optional): The due date for the issue in ISO format - estimate (number, optional): The numerical issue estimate value - links (array[object], optional): Array of link objects to attach to the issue. Each object must contain a valid url and a non-empty title.
linear_list_my_issues	List issues assigned to the current user	- limit (number, optional): The number of results to return (Max is 250) - before (string, optional): An ID to end at - after (string, optional): An ID to start from - orderBy (enum["createdAt", "updatedAt"], optional): The order in which to return results
linear_list_issue_statuses	List all workflow states for issues	- teamId (string, optional): Team ID to get states for
linear_list_issue_labels	List all issue labels	- teamId (string, optional): Team ID to get labels for
linear_create_issue_label	Create a new issue label	- name (string): Label name - description (string, optional): Label description - color (string, optional): Label color (hex code) - teamId (string, optional): Team ID
linear_list_comments	List comments for a specific issue	- issueId (string): Issue ID - first (number, optional): Number of comments to return - after (string, optional): Cursor for pagination
linear_create_comment	Create a new comment on an issue	- issueId (string): Issue ID - body (string): Comment content in markdown - createAsUser (string, optional): Name to display for the comment creator - displayIconUrl (string, optional): URL of the avatar to display
linear_list_cycles	List cycles with filtering and pagination	- first (number, optional): Number of cycles to return - after (string, optional): Cursor for pagination - team (string, optional): Filter by team ID - isActive (boolean, optional): Filter by active status
linear_list_documents	List documents with filtering and pagination	- first (number, optional): Number of documents to return - after (string, optional): Cursor for pagination - project (string, optional): Filter by project ID
linear_get_document	Get details of a specific document	- id (string): Document ID
linear_list_projects	List projects with filtering and pagination	- limit (number, optional): Number of projects to return - after (string, optional): Cursor for pagination - before (string, optional): Cursor for backward pagination - team (string, optional): Filter by team ID - query (string, optional): Search projects by name - state (enum["backlog", "planned", "started", "paused", "completed", "canceled"], optional): Filter by project state - includeArchived (boolean, optional): Include archived projects
linear_get_project	Get details of a specific project	- id (string): Project ID
linear_create_project	Create a new project	- name (string): Project name - description (string, optional): Project description - teamIds (array[string], optional): Team IDs - leadId (string, optional): Project lead user ID - memberIds (array[string], optional): Project member user IDs - startDate (string, optional): Project start date (ISO format) - targetDate (string, optional): Project target date (ISO format) - priority (number, optional): Project priority (1-4)
linear_update_project	Update an existing project	- id (string): Project ID - name (string, optional): Project name - description (string, optional): Project description - leadId (string, optional): Project lead user ID - memberIds (array[string], optional): Project member user IDs - startDate (string, optional): Project start date (ISO format) - targetDate (string, optional): Project target date (ISO format) - priority (number, optional): Project priority (1-4) - state (enum["backlog", "planned", "started", "paused", "completed", "canceled"], optional): Project state
linear_list_project_labels	List all project labels	- teamId (string, optional): Team ID to get project labels for
linear_list_teams	List teams with optional filtering by name or key	- limit (number, optional): Number of teams to return - after (string, optional): Cursor for pagination - before (string, optional): Cursor for backward pagination - query (string, optional): Search teams by name or key
linear_get_team	Get details of a specific team by ID	- id (string): Team ID
linear_list_users	List users with optional filtering by name or email	- limit (number, optional): Number of users to return - after (string, optional): Cursor for pagination - before (string, optional): Cursor for backward pagination - includeDisabled (boolean, optional): Include disabled users - query (string, optional): Search users by name, displayName, or email - name (string, optional): Filter users by name - email (string, optional): Filter users by email - active (boolean, optional): Filter by active status
linear_get_user	Get details of a specific user or current user	- id (string, optional): User ID (optional, defaults to current user)

Configuration

To use these tools, you need to configure a Linear Personal API Key

Creating your Linear Personal API Key:

Step 1: Navigate to your profile icon.

Step 2: Select 'Settings'.

Step 3: Click 'Security & access'.

Step 4: Go to the 'Personal API keys'.

Step 5: Click on 'New API key'.Step 6: Click the API key field and enter a name for your API.We recommend using "altimate-datamates" as the name for easier tracking.

Only Admins and permitted Members can create personal API keys from Settings > Account > Security & Access.