Connecting Linear
The Greppilot Linear integration enables interaction with your Linear workspace directly from the dashboard. It provides capabilities to manage issues, list projects, and update statuses.
Configuration
A Linear API Key is required for connection.
- In the Greppilot dashboard, navigate to Integrations.
- Select the Linear integration.
- Provide your Linear API Key in the designated
API Keyfield.
Generate a Personal API Key within your Linear settings under API. Ensure the key possesses adequate permissions for desired operations.
Your Linear API Key must begin with lin_api_. Keys are validated upon connection.
Available Tools
Upon successful connection, the following Linear tools become available:
list_teams
Lists all teams in the Linear workspace.
Parameters: None
list_issues
Lists issues in Linear, with optional filtering.
| Parameter | Type | Description | Required |
|---|---|---|---|
teamId | string | Filter by team ID. | No |
stateId | string | Filter by workflow state ID. | No |
assigneeId | string | Filter by assignee user ID. | No |
priority | number | Filter by priority: 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low. | No |
first | number | Number of issues to return (default: 25, max: 50). | No |
get_issue
Retrieves a single Linear issue by its identifier or internal ID.
| Parameter | Type | Description | Required |
|---|---|---|---|
id | string | Issue identifier (e.g., "ENG-123") or internal UUID. | Yes |
create_issue
Creates a new issue in Linear.
| Parameter | Type | Description | Required |
|---|---|---|---|
teamId | string | Team ID to create the issue in. | Yes |
title | string | Issue title. | Yes |
description | string | Issue description (markdown supported). | No |
priority | number | 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low. | No |
assigneeId | string | User ID to assign the issue to. | No |
stateId | string | Workflow state ID. | No |
labelIds | array | Array of label IDs to attach. | No |
update_issue
Updates an existing Linear issue.
| Parameter | Type | Description | Required |
|---|---|---|---|
id | string | Issue ID (UUID) to update. | Yes |
title | string | New title. | No |
description | string | New description. | No |
stateId | string | New workflow state ID. | No |
priority | number | 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low. | No |
assigneeId | string | New assignee user ID. | No |
list_projects
Lists projects in the Linear workspace.
| Parameter | Type | Description | Required |
|---|---|---|---|
teamId | string | Filter by team ID. | No |
first | number | Number of projects to return (default: 25). | No |
list_workflow_states
Lists workflow states (e.g., Todo, In Progress, Done) for a specific team.
| Parameter | Type | Description | Required |
|---|---|---|---|
teamId | string | Team ID to list states for. | Yes |