Linear
Connects to the Linear GraphQL API for working with issues and teams. An agent can list, search, create, and update issues, and look up team IDs.
Add to an agent node's tools array with _node_type: "tool-linear". See Connector Reference — How connectors are used.
Authentication
| Field | Required | Description |
|---|---|---|
api_key | Yes | Linear API key, sent directly as the Authorization header. Typically a stored secret. |
{
"name": "linear",
"_node_type": "tool-linear",
"api_key": "{{ secret.LINEAR_API_KEY }}"
}
Tools
linear_list_issues
List issues from Linear.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | string | No | Linear team ID to filter by |
state | string | No | Filter by state name (e.g. In Progress, Todo, Done) |
limit | number | No | Max issues to return (default 20) |
Returns: A newline-separated list of - [<identifier>] <title> (<state>) lines, or "No issues found.".
linear_create_issue
Create a new issue in Linear.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
team_id | string | Yes | Linear team ID |
title | string | Yes | Issue title |
description | string | No | Issue description (markdown) |
priority | number | No | Priority: 0=No priority, 1=Urgent, 2=High, 3=Medium, 4=Low |
Returns: A confirmation message with the new issue's identifier, title, and URL.
linear_update_issue_state
Move a Linear issue to a different workflow state.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
issue_id | string | Yes | Linear issue ID |
state_id | string | Yes | Target workflow state ID |
Returns: A confirmation message with the issue's identifier and new state name.
linear_search
Search issues in Linear by keyword.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query text |
limit | number | No | Max results (default 10) |
Returns: A newline-separated list of - [<identifier>] <title> (<state>) lines, or "No results.".
linear_list_teams
List all teams in the Linear workspace.
No parameters.
Returns: A newline-separated list of - <name> [<key>] (id: <id>) lines for every team.