linear

Query Linear's GraphQL API to manage issues, projects, and teams.

2|Updated Apr 25, 2026
One-click install
npx skills add https://github.com/AlexiosBluffMara/mercury --skill linear-alexiosbluffmara
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/AlexiosBluffMara/mercury/tree/main/skills/productivity/linear
Command: npx skills add https://github.com/AlexiosBluffMara/mercury --skill linear-alexiosbluffmara

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Streamline and automate the management of Linear work items by programmatically creating, updating, and querying issues, projects, and teams through GraphQL using an API key. This approach removes repetitive manual tasks and enables integration into scripts, CI/CD pipelines, and automation workflows.

Core Features & Use Cases

  • Create, update, and search Linear issues and projects via the GraphQL API.
  • Manage teams, workflows, and key metadata without a GUI.
  • Use in automation scenarios (scripts, bots, or CI) to maintain up-to-date work items.

Quick Start

Authenticate with your Linear API key and run a simple curl command to fetch the current user.

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 the GraphQL API?

Automate Linear issue management by sending GraphQL queries and mutations via curl HTTP POST requests to the Linear API, requiring a valid Linear API key for authentication to create, update, or search issues programmatically.

Can I update Linear projects and teams from a CI/CD pipeline?

Yes, you can update Linear projects and teams from CI/CD pipelines by executing curl commands against the Linear GraphQL endpoint, enabling automated project updates and team administration without manual GUI interaction.

Do I need a Linear API key to query issues via GraphQL?

Yes, a Linear API key is required to authenticate GraphQL API requests. You must include this key in your curl HTTP POST requests to successfully query or mutate Linear issues, projects, and teams.

What is the best way to integrate Linear issue tracking into custom automation scripts?

The best way to integrate Linear issue tracking into automation scripts is using GraphQL API calls with curl, allowing you to programmatically manage issues, projects, and team workflows directly from your custom scripts.

Are there limitations when using curl for Linear GraphQL API automation?

Using curl for Linear GraphQL API automation requires handling HTTP POST request construction and JSON response parsing manually, which may increase complexity for large automation workflows compared to native API SDKs.