The Linear connector synchronizes issues from Linear using the GraphQL API.
Authentication
OAuth — requires scope: read
Configuration
| Field | Type | Required | Description |
|---|---|---|---|
| Team | Selector / Input | No | Team to sync from |
| Project | Selector / Input | No | Project to sync from |
| State Filter | Input | No | Comma-separated states (e.g., "In Progress, Todo") |
| Max Issues | Input | No | Limit the number of synced issues |
How It Works
- Dynamic Query Building — Builds a GraphQL query with only active filters
- Team Validation — Validates team ID exists during setup
- Issue Fetching — Uses Relay cursor pagination
- Markdown Stripping — Converts Linear's Markdown descriptions to plain text
Document Format
TEAM-123: Issue title
Status: In Progress
Priority: High
Assignee: Name
Labels: label1, label2
Plain text description...Metadata Tags
| Tag | Type | Description |
|---|---|---|
| Labels | Text | Comma-separated labels |
| State | Text | Workflow state |
| Priority | Text | Priority level |
| Assignee | Text | Assigned person |
| Last Modified | Date | When the issue was last updated |
GraphQL Efficiency
The query only includes filter clauses that have values, preventing null comparators from being sent to Linear's API.