Linear

Metadata	Value
Category	dev
Capabilities	http
Website	https://linear.app

Returns shapes

• project[] — from list_projects
• task — from get_task, create_task, update_task
• task[] — from list_tasks

Connections

• api

Readme

Project management integration for engineering teams.

Linear issues map to tasks and projects map to projects on the AgentOS graph.

Setup

1. Get your API key from https://linear.app/settings/api
2. Add credential in AgentOS Settings → Connectors → Linear

Important: Linear API keys are used WITHOUT the “Bearer” prefix.

Features

• Full CRUD for tasks (issues)
• Projects and cycles
• Workflow states (customizable per team)
• Sub-tasks via parent_id
• Issue relationships (blocking, related)

Workflow

Linear uses customizable workflow states per team. Common patterns:

State Type	Typical Names	Maps to
backlog	Backlog, Triage	open
unstarted	Todo	open
started	In Progress, In Review	in_progress
completed	Done	done
canceled	Canceled	cancelled

To change an issue’s state, use update_task with state_id from get_workflow_states.

Priority Scale

Value	Meaning
0	No priority
1	Urgent
2	High
3	Medium
4	Low

Completing Issues

To mark an issue complete:

1. Call get_workflow_states with the issue’s team_id
2. Find the state with type: "completed"
3. Call update_task with the issue id and state_id