Linear — Issue & Project Management

Manage Linear issues, projects, and teams directly via the GraphQL API using curl. No MCP server, no OAuth flow, no extra dependencies.

Setup

1. Get a personal API key from Linear Settings > API > Personal API keys
2. Set LINEAR_API_KEY in your environment (via hermes setup or your env config)

API Basics

• Endpoint: https://api.linear.app/graphql (POST)
• Auth header: Authorization: $LINEAR_API_KEY (no "Bearer" prefix for API keys)
• All requests are POST with Content-Type: application/json
• Both UUIDs and short identifiers (e.g., ENG-123) work for issue(id:)