Linear Integration

Pro v1.0.0

Manage Linear issues, projects, and teams via GraphQL API

Requires Claude Code CLI

This skill integrates with Linear through Claude Code. Install Claude Code and add this skill to use it.

Available Actions

List Issues

List issues with optional filtering by team, assignee, or state

Parameters

Name Type Required Description
team string Optional Team key to filter by
assignee string Optional Assignee email to filter by
state string Optional State name to filter by

Returns

array Array of issue objects with id, identifier, title, state, assignee, team, and URL

Try saying...

  • "Show me all issues for the backend team"
  • "List issues assigned to me"
  • "What issues are in progress?"
  • "Show backlog items for the frontend team"

Get Issue

Get detailed information about a specific issue, including comments

Parameters

Name Type Required Description
issue_id string Required Issue ID or identifier (e.g., ENG-123)

Returns

object Issue object with full details including description, comments, priority, and estimate

Try saying...

  • "Get details for issue ENG-123"
  • "Show me the full information on PROD-456"
  • "What are the comments on issue FE-789?"

Create Issue

Create a new issue with title, team, and optional description and assignee

Parameters

Name Type Required Description
title string Required Issue title
team string Required Team key
description string Optional Issue description (supports Markdown)
assignee string Optional Assignee email address

Returns

object Created issue object with id, identifier, title, and URL

Try saying...

  • "Create a bug report for the mobile login issue"
  • "Add a new feature request to the backend team"
  • "Create an issue for dark mode support and assign it to the design team"

Update Issue

Update an existing issue's title, state, or assignee

Parameters

Name Type Required Description
issue_id string Required Issue ID or identifier
title string Optional New title
state string Optional New state name
assignee string Optional New assignee email

Returns

object Updated issue object

Try saying...

  • "Mark issue ENG-123 as done"
  • "Move PROD-456 to in progress"
  • "Assign issue FE-789 to me"
  • "Update the title of issue ENG-123"

Add Comment

Add a comment to an existing issue

Parameters

Name Type Required Description
issue_id string Required Issue ID or identifier
comment string Required Comment text (supports Markdown)

Returns

object Created comment object with id, body, and timestamp

Try saying...

  • "Add a comment to issue ENG-123 with my progress update"
  • "Comment on PROD-456 that it's blocked"
  • "Add a note to issue FE-789"

List Teams

List all teams in the workspace

Returns

array Array of team objects with id, key, name, and description

Try saying...

  • "Show me all teams"
  • "What teams exist in this workspace?"
  • "List available teams"

List Projects

List projects with optional team filtering

Parameters

Name Type Required Description
team string Optional Team key to filter by

Returns

array Array of project objects with id, name, description, state, dates, team, and URL

Try saying...

  • "Show me all projects"
  • "List projects for the engineering team"
  • "What projects are active?"
  • "Show backend team projects"

Getting Started

API Key Easy Setup
  1. 1 Go to Linear Settings > API (https://linear.app/settings/api)
  2. 2 Click 'Create new API key'
  3. 3 Choose permissions (Read/Write/Admin)
  4. 4 Copy the key (starts with lin_api_)
  5. 5 Add to shell config: echo 'export LINEAR_API_KEY="YOUR_KEY"' >> ~/.zshrc
  6. 6 Restart terminal or run: source ~/.zshrc

Verify Setup

[ -n "$LINEAR_API_KEY" ] && echo "API key configured" || echo "API key not found"

Success: API key configured

View full setup guide

Security & Access

Access Scope

Full access to all Linear data and actions that your user account can access, including reading issues, creating/updating issues, adding comments, and managing projects

  • API keys grant the same permissions as your user account
  • Keys with Write permissions can modify or delete data
  • Keys with Admin permissions can change team and workspace settings
  • Revoke compromised keys immediately at https://linear.app/settings/api

Limitations

  • No automatic pagination for large result sets (capped at 50 items per query)
  • State names must match exactly (case-sensitive)
  • Team keys and email addresses must be valid or queries will fail

Get This Skill

Requires Pro subscription ($9/month)

Quick Reference

Type
GraphQL
Auth
API Key
Setup
Easy Setup
Tools Required
Bash
Python Dependencies
requests>=2.28.0

Documentation

Have Feedback?

Help us improve this skill by sharing your ideas and suggestions.

Request Improvements