✓ Verified 💻 Development ✓ Enhanced Data

Native Linear

Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API.

Rating: 3.9 (350 reviews)
Downloads: 2,756 downloads
Version: 1.0.0

Overview

Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API.

Complete Documentation

View Source →

Linear

Interact with Linear directly via the Linear GraphQL API (api.linear.app/graphql).

Setup (one-time)

Go to Linear → Settings → Account → Security & Access → API keys
Create a new key
Set environment variable:

text

LINEAR_API_KEY=lin_api_...

Usage

List your teams

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py teams

List issues assigned to you

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"

List issues for a team

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20

Get a specific issue

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py issue ENG-123

Search issues

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py search "authentication bug"

Create an issue

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2

Update an issue

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"

List projects

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"

List cycles (sprints)

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py cycles --team "Engineering"

List workflow states for a team

bash

python3 /mnt/skills/user/linear/scripts/linear_query.py states --team "Engineering"

Priority levels

0 = No priority
1 = Urgent
2 = High
3 = Normal
4 = Low

Installation

Terminal bash


openclaw install native-linear

Copied!

💻Code Examples

### List issues assigned to you

-list-issues-assigned-to-you.sh

python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues
python3 /mnt/skills/user/linear/scripts/linear_query.py my-issues --state "In Progress"

### List issues for a team

-list-issues-for-a-team.sh

python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering"
python3 /mnt/skills/user/linear/scripts/linear_query.py issues --team "Engineering" --state "Todo" --limit 20

### Create an issue

-create-an-issue.sh

python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Fix login bug" --description "Users can't log in on Safari"
python3 /mnt/skills/user/linear/scripts/linear_query.py create --team "Engineering" --title "Add dark mode" --priority 2

### Update an issue

-update-an-issue.sh

python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --state "Done"
python3 /mnt/skills/user/linear/scripts/linear_query.py update ENG-123 --priority 1 --title "New title"

### List projects

-list-projects.sh

python3 /mnt/skills/user/linear/scripts/linear_query.py projects
python3 /mnt/skills/user/linear/scripts/linear_query.py projects --team "Engineering"