Linear

---

name: linear

description: "Query and manage Linear issues, projects, cycles, and teams via the Linear GraphQL API. Use when you need to list or create issues, check cycle status, manage projects, or search across your workspace. Calls api.linear.app directly with no third-party proxy."

metadata:

openclaw:

requires:

env:

- LINEAR_API_KEY

bins:

- python3

primaryEnv: LINEAR_API_KEY

files:

- "scripts/*"

---

# Linear

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

Setup (one-time)

1. Go to Linear → Settings → Account → Security & Access → API keys

2. Create a new key

3. Set environment variable:

```

LINEAR_API_KEY=lin_api_...

```

Usage

List your teams

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

List issues assigned to you

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

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

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

Search issues

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

Create an issue

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

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

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)

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

List workflow states for a team

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

Priority levels