linear

Query and mutate Linear issues, projects, and teams via GraphQL with curl.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline managing Linear issues, projects, and teams by using a GraphQL API accessed through curl with an API key, enabling automation without a full client.

Core Features & Use Cases

  • GraphQL-based operations for creating, updating, listing, and organizing Linear items (issues, projects, teams) using a simple curl workflow.
  • API-key authentication via LINEAR_API_KEY; no OAuth required.
  • Typical workflows include querying the current user, listing teams and issues, creating issues, updating states, and assigning items.

Quick Start

Set LINEAR_API_KEY in your environment and run a sample curl command against the GraphQL endpoint to verify access.

Frequently Asked Questions about linear

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

FAQPage Schema
How do I manage Linear issues using curl and GraphQL?

You can manage Linear issues by sending curl requests to the https://api.linear.app/graphql endpoint with a LINEAR_API_KEY. This allows you to query data and mutate issues, projects, and teams individually or in batches.

What do I need to automate Linear workflows without a full client?

You need the LINEAR_API_KEY environment variable set and curl installed to automate Linear workflows. This setup enables API-key authentication and GraphQL operations without requiring OAuth or a full client.

Can I batch create and update Linear projects with a GraphQL API?

Yes, you can batch create and update Linear projects and issues using GraphQL mutations sent via curl. This approach supports applying workflows that create, search, update, and organize Linear items in batch.

Does the Linear API require OAuth for curl-based automation?

No, the Linear API does not require OAuth for curl-based automation. It uses API-key authentication via the LINEAR_API_KEY environment variable to access the GraphQL endpoint directly.

What GraphQL operations can I perform on Linear teams and issues?

You can perform GraphQL-based operations for creating, updating, listing, and organizing Linear items including issues, projects, and teams. Typical workflows cover querying the current user, listing teams, and assigning items.

Why use curl to interact with the Linear GraphQL API instead of other tools?

Using curl to interact with the Linear GraphQL API provides a simple method for automation without needing a full client. It streamlines managing issues and projects directly through API-key authenticated requests.