Linear Integration

Connect your Linear workspace to index issues, projects, and cycles.

Quick Start

const connector = await client.createConnector({
  connector_type: 'linear',
  display_name: 'Company Linear',
  credentials: {
    api_key: 'lin_xxxxxxxxxxxx',
  },
});

await client.syncConnector(connector.connector_id, true);

Authentication

Personal API Key

{
  "credentials": {
    "api_key": "lin_xxxxxxxxxxxx"
  }
}

OAuth 2.0

GET /v1/connectors/linear/oauth-url

Synced Content

Content Type	Description	Indexed Fields
Issues	Tasks, bugs	Title, Description, Comments
Projects	Initiatives	Name, Description, Updates
Cycles	Sprints	Name, Goals
Documents	Project docs	Title, Content

Configuration

{
  "settings": {
    "teams": ["Engineering", "Product"],
    "include_archived": false,
    "include_comments": true,
    "sync_attachments": true
  }
}

GraphQL API

Linear uses GraphQL. Metalogue wraps this in a unified interface:

const results = await client.query({
  text: 'authentication bug login',
  filters: {
    connector_type: 'linear',
    document_type: 'issue'
  }
});

Webhooks

Real-time sync via Linear webhooks:

• Issue created/updated
• Comment added
• Project milestone

Rate Limits

• 100 requests/minute
• Automatic rate limiting

Next Steps

• Jira Integration
• Asana Integration