Linear

Manage Linear issues, projects, and teams via MCP, SDK scripts, or GraphQL API.

1|Updated Jan 20, 2026
One-click install
npx skills add https://github.com/sorafujitani/claudedot --skill linear-sorafujitani
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Linear
Source: https://github.com/sorafujitani/claudedot/tree/main/skills/linear
Command: npx skills add https://github.com/sorafujitani/claudedot --skill linear-sorafujitani

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires @linear/sdk, and includes scripts (resource) components.

What problem does it solve?

Linear helps software teams coordinate work across issues, projects, and team workflows inside Linear, reducing manual overhead and context switching.

Core Features & Use Cases

  • Tooling guidance: MCP tools for simple operations, SDK scripts for complex automation, and GraphQL API as a fallback.
  • SDK Automation Scripts: Write TypeScript scripts using @linear/sdk to handle loops, bulk updates, and data transformations.
  • Reference and usage: Examples for fetching issues, creating/updating issues, and scripting patterns to integrate Linear with workflows.

Quick Start

Create or update a Linear issue by providing a team, title, and optional state and assignee.

Frequently Asked Questions about Linear

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

FAQPage Schema
How do I automate creating and updating Linear issues in bulk?

Automate bulk Linear issue management by writing TypeScript scripts with the @linear/sdk package. This approach handles loops, applies data transformations, and executes bulk updates across team workflows efficiently.

What is the best way to manage Linear projects and team workflows programmatically?

Manage Linear projects programmatically using MCP tools for simple operations or SDK scripts for complex automation. The GraphQL API acts as a fallback for direct queries and custom team workflow coordination.

Does the Linear SDK support GraphQL API queries for fetching issues?

Yes, the Linear SDK supports GraphQL API queries for fetching issues. The @linear/sdk dependency enables querying issues, managing project structures, and interacting with data using GraphQL conventions.

Can I use MCP tools for simple Linear issue operations instead of writing scripts?

Yes, MCP tools handle simple Linear issue operations like basic fetching or updates. SDK scripts are recommended for complex automation involving loops and bulk updates, while the GraphQL API serves as a fallback.

When should I use the Linear GraphQL API directly instead of the SDK?

Use the Linear GraphQL API directly as a fallback when SDK scripts or MCP tools cannot meet specific custom query needs. It provides direct access for fetching issues and managing project structures outside standard SDK conventions.

What do I need to authenticate and manage Linear issues using the SDK?

Authenticating and managing Linear issues with the SDK requires the @linear/sdk dependency and valid API credentials. Following conventions for issue states, labels, and authentication ensures successful team workflow coordination.