linear-api

Manage Linear issues, projects, cycles, teams, comments, and labels via the GraphQL API.

37|13|Updated Jun 23, 2026
One-click install
npx skills add https://github.com/anthropics/claude-tag-plugins --skill linear-api-anthropics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear-api
Source: https://github.com/anthropics/claude-tag-plugins/tree/main/linear/skills/linear-api
Command: npx skills add https://github.com/anthropics/claude-tag-plugins --skill linear-api-anthropics

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires curl, jq, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill removes the friction of working with Linear by letting you search, read, create, and update issues without manually navigating the app or GraphQL schema.

Core Features & Use Cases

  • Read and manage issues, comments, labels, teams, projects, and cycles.
  • Filter and page through large issue lists, including work assigned to you or matching a search term.
  • Update workflow state, assignee, priority, and comments, or create new issues from a team.
  • Use case: quickly answer "what's on my plate in Linear," move an issue to In Progress, or inspect a project’s current status.

Quick Start

Use the linear-api skill to list my open Linear issues and summarize the highest-priority items.

Frequently Asked Questions about linear-api

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

FAQPage Schema
How do I manage Linear issues without navigating the app?

You can manage Linear issues by using GraphQL API requests to search, read, create, and update items directly. This approach removes the friction of manual app navigation by handling workflow states, assignees, and comments through bundled curl and jq scripts.

Can I filter and page through large lists of Linear issues?

Yes, you can filter and page through large Linear issue lists using cursor pagination. This allows you to retrieve work assigned to specific users or matching search terms without hitting bulk query limits.

How do I update a Linear issue's workflow state and priority via API?

To update a Linear issue's state or priority, you execute UUID-based GraphQL mutations. These mutations allow you to move work items to In Progress, change assignees, and update labels with strict GraphQL error checking.

Does this Linear API approach handle human-readable issue identifiers and URLs?

Yes, the Linear API approach applies to requests triggered by Linear URLs and human-readable issue identifiers. It maps these readable formats to the required UUID-based mutations for accurate issue tracking and updates.

Do I need curl and jq to interact with the Linear GraphQL API?

Yes, curl and jq are required dependencies for interacting with the Linear GraphQL API using this method. The Skill relies on bundled curl and jq scripts to execute requests and process JSON responses.

What's the best way to list my open Linear issues and summarize priorities?

The best way to list open Linear issues and summarize priorities is querying the Linear GraphQL API with cursor pagination. You can filter by assignee and sort by priority to quickly inspect your current workload.