linear

Query and mutate Linear workspace data via GraphQL API.

8|1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/mnlt/teleport --skill linear-mnlt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/mnlt/teleport/tree/main/skills/linear
Command: npx skills add https://github.com/mnlt/teleport --skill linear-mnlt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This GraphQL-based skill provides programmatic access to Linear workspace data—reading issues, projects, cycles, teams, and comments—and supports mutations to update state or create items, eliminating manual navigation.

Core Features & Use Cases

  • GraphQL API access to query and mutate Linear workspace data (issues, projects, cycles, teams, comments).
  • Common workflows: list issues with filters, create issues, update issue state, and fetch teams and projects for context.
  • Use Case: automate weekly status reporting by listing open issues assigned to you and their statuses, then apply bulk updates as needed.

Quick Start

Ask me to list issues in a project, create an issue, or update an issue's state using Linear GraphQL.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I automate listing and updating Linear issues via GraphQL?

To automate Linear issues via GraphQL, you send POST requests to the Linear API endpoint with JSON payloads. This allows you to query workspace data and execute mutations to list, create, or update issues programmatically.

What is the correct authorization header format for Linear GraphQL API requests?

The Linear GraphQL API requires the Authorization header to be set directly to your API key. Unlike standard Bearer token authentication, you simply pass the key without the Bearer prefix in the request header.

Can I use Linear GraphQL to fetch workspace context like teams, projects, and cycles?

Yes, you can fetch workspace context like teams, projects, and cycles using Linear GraphQL. By structuring your JSON queries appropriately, you can retrieve comprehensive workspace state to support end-to-end automation workflows.

How do I create a Linear issue and update its state using a GraphQL mutation?

To create a Linear issue and update its state, you execute GraphQL mutations via POST requests to the Linear API. You construct JSON payloads defining the desired issue attributes and target state to apply changes.

Does the Linear GraphQL API have rate limits I need to handle during workflows?

Yes, the Linear GraphQL API enforces rate limits that require proper handling during workflows. You must implement rate-limit handling logic in your automation scripts to prevent request throttling when querying or mutating workspace data.

What is the best way to automate weekly status reporting from Linear data?

The best way to automate weekly status reporting from Linear data is querying open issues and their statuses via GraphQL. You can list assigned issues, fetch current states, and apply bulk updates as needed.