Manage issues, projects, teams, and workflows with Linear
The Linear integration provides comprehensive project management and issue tracking through GraphQL API. You can manage issues with detailed tracking, organize teams and projects, track workflow states, assign tasks, add comments, and manage labels for organization. This integration supports the full Linear workflow including creating issues, updating status, team collaboration, and project management. Perfect for development teams looking to automate their Linear workflows and integrate with other tools.
Required:
action
- The operation you want to perform (get_user, get_issues, create_issue, update_issue, get_teams, get_projects, etc.)Optional:
team_id
- Team identifier for team-specific operationsissue_id
- Issue identifier for issue-specific operationsproject_id
- Project identifier for project operationsRetrieve information about the authenticated user
Parameters:
action
(required) - Set to “get_user”Example:
Response:
Retrieve a list of issues with filtering options
Parameters:
action
(required) - Set to “get_issues”team_id
(optional) - Filter by specific teamExample:
Response:
Retrieve detailed information about a specific issue
Parameters:
action
(required) - Set to “get_issue”issue_id
(required) - The issue identifierExample:
Response:
Create a new issue in Linear
Parameters:
action
(required) - Set to “create_issue”title
(required) - Issue titledescription
(required) - Issue descriptionteam_id
(required) - Team identifierpriority
(optional) - Priority level (1-4, where 1 is urgent)assignee_id
(optional) - User ID to assign the issue tolabel_ids
(optional) - Array of label IDsExample:
Response:
Update an existing issue
Parameters:
action
(required) - Set to “update_issue”issue_id
(required) - Issue identifiertitle
(optional) - Updated titledescription
(optional) - Updated descriptionpriority
(optional) - Updated prioritystate_id
(optional) - New workflow state IDExample:
Response:
Retrieve all teams and their information
Parameters:
action
(required) - Set to “get_teams”Example:
Response:
Retrieve issues for a specific team
Parameters:
action
(required) - Set to “get_team_issues”team_id
(required) - Team identifierExample:
Response:
Retrieve all projects with progress and details
Parameters:
action
(required) - Set to “get_projects”Example:
Response:
Retrieve workflow states for teams
Parameters:
action
(required) - Set to “get_workflow_states”Example:
Response:
Add a comment to an issue
Parameters:
action
(required) - Set to “create_comment”issue_id
(required) - Issue identifierbody
(required) - Comment textExample:
Response:
Retrieve labels for filtering and organization
Parameters:
action
(required) - Set to “get_labels”Example:
Response:
Retrieve team members for assignment
Parameters:
action
(required) - Set to “get_users”Example:
Response:
Linear uses GraphQL API with all requests as POST to the graphql endpoint. Team IDs are mandatory for creating issues - always ask users for team_id when required. Issue identifiers follow the pattern TEAM-NUMBER (e.g., DEV-123). Priority levels are 1-4 where 1 is urgent and 4 is low. Workflow states have types like backlog, unstarted, started, completed, and canceled. All timestamps are in ISO 8601 format. Labels have color codes for visual organization. The system supports nested data structures for comprehensive issue tracking.