linear

Manage Linear issues, projects, and teams via the GraphQL API using curl.

Updated Apr 27, 2026
One-click install
npx skills add https://github.com/AissenLiu/EasyHermes --skill linear-aissenliu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/AissenLiu/EasyHermes/tree/main/hermes-agent/skills/productivity/linear
Command: npx skills add https://github.com/AissenLiu/EasyHermes --skill linear-aissenliu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill enables programmatic management of Linear issues, projects, and teams directly through the GraphQL API using curl, eliminating manual API fiddling and enabling automation without OAuth or extra dependencies.

Core Features & Use Cases

  • GraphQL-based operations to query and mutate issues, projects, and teams.
  • Simple authentication using an API key (LINEAR_API_KEY) and the GraphQL endpoint https://api.linear.app/graphql.
  • Supports common workflows such as listing issues, creating issues, updating statuses, assigning owners, and retrieving team/project data for automation across teams.

Quick Start

Set LINEAR_API_KEY in your environment and run a curl command to list 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 using GraphQL?

Automate Linear issue management by sending GraphQL queries and mutations to the Linear API endpoint using curl. This requires setting the LINEAR_API_KEY environment variable to authenticate requests for creating, updating, and listing issues programmatically.

Can I manage Linear projects and teams without setting up OAuth?

Yes, you can manage Linear projects and teams without OAuth by using a simple API key. Set the LINEAR_API_KEY environment variable to authenticate curl requests against the GraphQL endpoint directly, avoiding complex OAuth flows.

What's the best way to create and update Linear issues from a script?

The best way to create and update Linear issues from a script is using curl commands to POST GraphQL mutations to the Linear API. Provide the issue details in the GraphQL payload and authenticate via the LINEAR_API_KEY environment variable.

Do I need any extra dependencies or libraries to interact with the Linear API?

No extra dependencies or libraries are needed to interact with the Linear API. You only need curl installed on your system and a valid LINEAR_API_KEY to execute GraphQL operations for querying and mutating issues, projects, and teams.

How does GraphQL work with the Linear API for retrieving team data?

GraphQL works with the Linear API by allowing you to specify exact data fields in a curl request to the endpoint. You query team and project data structures directly, retrieving only the necessary information for your workflow automation.

Why does my curl command fail when trying to list Linear issues?

Your curl command may fail when listing Linear issues if the LINEAR_API_KEY environment variable is missing or incorrect, or if your API key lacks the proper permissions to access the Linear GraphQL endpoint at api.linear.app/graphql.