linear

Manage Linear issues, teams, and projects via GraphQL API.

9|3|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/Pythagora-io/agent-templates --skill linear-pythagora-io
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/Pythagora-io/agent-templates/tree/main/Developer%20Agent/linear
Command: npx skills add https://github.com/Pythagora-io/agent-templates --skill linear-pythagora-io

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Linear project management tasks can be automated and queried via GraphQL, reducing manual work and context switching.

Core Features & Use Cases

  • Create, read, update, and search Linear issues, projects, and states through a single API client.
  • List teams, issues assigned to users, add comments, and manage workflows across multiple teams.
  • Use cases include creating issues from a ticket, moving tasks to In Progress, and fetching status summaries for reporting.

Quick Start

Use the provided Python script to connect to Linear and list the first 10 issues for a team.

Frequently Asked Questions about linear

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate Linear issue management via GraphQL?

Automate Linear issue management by executing GraphQL operations through a Python script to create, read, update, and list issues, teams, and projects. This reduces manual project management work and context switching.

Can I update Linear issue statuses and add comments programmatically?

Yes, you can update Linear issue statuses and add comments programmatically. The API client script manages these workflow transitions and assignments directly, allowing automated task progression across multiple teams.

What is the best way to fetch Linear project status summaries for reporting?

Fetch Linear project status summaries by querying team activity and listing assigned issues via GraphQL. This provides automated status updates for reporting without requiring manual dashboard checks.

Do I need a Linear API key to query workspace data with Python?

Yes, a Linear API key is required. Provide the key via a command-line argument, the LINEAR_API_KEY environment variable, or an auth-profiles.json file to authenticate the Python script's GraphQL requests.

Can I manage multiple Linear teams from a single Python script?

Yes, you can manage multiple Linear teams from a single Python script. The API client lists teams and issues, enabling you to cross-query team activity and manage workflows across different groups.

Why use GraphQL instead of REST for Linear workspace automation?

Using GraphQL for Linear workspace automation allows precise querying of issues, projects, and states through a single API endpoint. This approach efficiently retrieves structured data for complex workflow automation.