Linear Node

Comprehensive integration with Linear project management platform, enabling automated issue tracking, team coordination, and project management workflows with full GraphQL API support.

Available Operations

• Issue Management: Create, update, retrieve, and search issues with comprehensive filtering
• Team Coordination: Access teams, users, workflow states, labels, and cycles
• Project Management: Manage projects, cycles, and organizational structure
• Collaboration: Add comments and manage threaded discussions
• Resource Discovery: List and filter all Linear workspace resources

Connection Configuration

{
  "apiKey": "{{ctx.consts.LINEAR_API_KEY}}",
  "baseUrl": "https://api.linear.app/graphql"
}

Issue Management Operations

createIssue

Create a new issue with comprehensive options for assignment, prioritization, and organization.

{
  "title": "{{ctx.vars.issueTitle}}",
  "teamId": "{{ctx.vars.teamId}}",
  "description": "## Overview\n\n{{ctx.nodes.descriptionGenerator.outputs.description}}",
  "assigneeId": "{{ctx.vars.assigneeId}}",
  "priority": 2,
  "estimate": 8,
  "dueDate": "{{ctx.vars.dueDate}}"
}

updateIssue

Update an existing issue with new values for any supported field.

{
  "issueId": "{{ctx.vars.issueId}}",
  "stateId": "{{ctx.vars.newStateId}}",
  "assigneeId": "{{ctx.user.linearUserId}}",
  "estimate": "{{ctx.vars.updatedEstimate}}"
}

getIssue

Retrieve detailed information about a specific issue including metadata and optional comments.

{
  "issueId": "{{ctx.vars.issueIdentifier}}",
  "includeComments": true
}

listIssues

Search and list issues with advanced filtering and pagination support.

{
  "teamId": "{{ctx.vars.teamFilter}}",
  "assigneeId": "{{ctx.user.linearUserId}}",
  "stateId": "{{ctx.vars.activeStateId}}",
  "search": "{{ctx.vars.searchQuery}}",
  "limit": 50
}

addComment

Add a comment to an existing issue with support for threaded replies.

{
  "issueId": "{{ctx.vars.issueId}}",
  "body": "{{ctx.nodes.commentGenerator.outputs.commentText}}",
  "parentId": "{{ctx.vars.parentCommentId}}"
}

Resource Discovery Operations

listTeams

Retrieve all teams in the Linear workspace for use in other operations.

No parameters required - returns all accessible teams with IDs, names, keys, and metadata.

{}

listUsers

Retrieve all users in the Linear workspace for assignee operations.

No parameters required - returns all accessible users with IDs, names, email addresses, and metadata.

{}

listWorkflowStates

Retrieve workflow states for a specific team to understand available issue states.

{
  "teamId": "{{ctx.vars.teamId}}"
}

listLabels

Retrieve labels in the workspace, optionally filtered by team.

{
  "teamId": "{{ctx.vars.teamFilter}}"
}

listCycles

Retrieve cycles for a specific team with completion status filtering.

{
  "teamId": "{{ctx.vars.teamId}}",
  "includeCompleted": false
}

listProjects

Retrieve projects in the workspace with team and completion filtering.

{
  "teamId": "{{ctx.vars.teamFilter}}",
  "includeCompleted": true
}

Workflow Integration

Use workflow context for dynamic issue management:

{
  "title": "{{ctx.vars.eventType}} - {{ctx.user.department}}",
  "teamId": "{{ctx.nodes.teamSelector.outputs.selectedTeam}}",
  "description": "**Automated Issue**\n\n{{ctx.nodes.issueGenerator.outputs.description}}\n\n**Context:**\n- User: {{ctx.user.name}}\n- Triggered: {{ctx.vars.currentDateTime}}",
  "assigneeId": "{{ctx.nodes.userLookup.outputs.assigneeId}}",
  "priority": "{{ctx.vars.calculatedPriority}}",
  "labelIds": "{{ctx.nodes.labelMapper.outputs.applicableLabels}}"
}

Response Format

Success Response

{
  "success": true,
  "issue": {
    "id": "issue_abc123",
    "identifier": "ENG-456",
    "title": "Implement user dashboard",
    "state": {
      "name": "In Progress",
      "type": "started"
    },
    "assignee": {
      "name": "John Doe",
      "email": "john@company.com"
    },
    "team": {
      "name": "Engineering",
      "key": "ENG"
    },
    "url": "https://linear.app/company/issue/ENG-456"
  }
}

Error Response

{
  "success": false,
  "error": "Team not found",
  "code": "TEAM_NOT_FOUND"
}

Priority Levels

Use Cases

• Automated Issue Creation: Generate issues from monitoring alerts, user feedback, or workflow events
• Issue Lifecycle Management: Move issues through workflow states based on external triggers
• Team Coordination: Automatically assign issues based on team capacity or expertise
• Project Tracking: Link issues to projects and cycles for comprehensive project management
• Progress Reporting: Query issues and projects to generate status reports and metrics
• Integration Workflows: Sync Linear issues with external tools and systems

Authentication

Linear uses API key authentication with the GraphQL endpoint. The API key provides access based on the user's permissions in the Linear workspace.

Required Permissions:

• Read access to teams, users, and workspace metadata
• Create/update access for issue management operations
• Comment access for collaboration features

Getting Started

1. Obtain API Key: Generate an API key in Linear Settings → API
2. Identify Resources: Use list operations to discover team IDs, user IDs, and other required identifiers
3. Configure Operations: Set up issue creation and management operations with proper team and user mappings
4. Test Integration: Validate issue operations and workflow integration before production deployment
5. Monitor Usage: Track API usage and implement rate limiting as needed for high-volume operations