linear

Automate Linear issue, project, team, and document operations via GraphQL.

11|Updated May 17, 2026
One-click install
npx skills add https://github.com/StarryCod/cogitum --skill linear-starrycod
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: linear
Source: https://github.com/StarryCod/cogitum/tree/main/cogitum/data/skills/productivity/linear
Command: npx skills add https://github.com/StarryCod/cogitum --skill linear-starrycod

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill enables programmatic access to Linear's issues, projects, teams, and documents through GraphQL, enabling quick automation and scripting without OAuth flows or MCP servers.

Core Features & Use Cases

  • GraphQL-based operations for issues, projects, teams, and documents.
  • Command-line helper scripts for common tasks (whoami, list-issues, get-issue, etc.)
  • Support for both curl-based requests and a Python CLI for ergonomic use.
  • No MCP server; uses a personal API key.

Quick Start

Set LINEAR_API_KEY and run scripts/linear_api.py whoami 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 automate Linear issues and projects access via GraphQL?

You can automate Linear issues, projects, teams, and documents by sending GraphQL requests via curl or a Python CLI. The skill requires a LINEAR_API_KEY to query, create, update, and retrieve data without needing an OAuth flow.

Do I need an MCP server to script Linear data retrieval?

No, you do not need an MCP server to script Linear data retrieval. This skill uses a personal LINEAR_API_KEY to directly execute curl-based GraphQL requests, bypassing complex OAuth flows or MCP setups for quick automation.

What is the best way to query Linear issues in CI workflows?

The best way to query Linear issues in CI workflows is using the included Python CLI. After setting your LINEAR_API_KEY, run scripts like `scripts/linear_api.py list-issues` to automate data retrieval directly within your pipeline.

Can I create and update Linear documents using curl?

Yes, you can create and update Linear documents using curl. The skill supports GraphQL-based operations for documents, issues, and projects, allowing direct data manipulation through simple curl commands authenticated with a LINEAR_API_KEY.

What are the limitations of using a personal API key for Linear automation?

Using a personal API key for Linear automation limits access to the key owner's permissions and does not support OAuth flows or MCP servers. It is designed for quick scripting and CI workflows rather than complex multi-user application integrations.