Linear MCP Integration

Use Linear MCP server functions to interact with Linear's project management system.

Prerequisites

• Linear MCP server configured and available

• Authentication: Linear API token configured in MCP server

• Access to Linear workspace

Quick Start

Get issue details:

mcp_Linear_get_issue({ id: "LIN-123", includeRelations: true // get related/blocking issues })

List issues:

mcp_Linear_list_issues({ team: "Engineering", state: "In Progress" })

Usage Patterns for PR Review

Fetch Issue Requirements

Step 1: Extract Issue ID from PR

• Look for Linear issue references in PR title/body (e.g., LIN-123 , [LIN-123] )

• Extract issue identifier

Step 2: Get Issue Details

mcp_Linear_get_issue({ id: "LIN-123", // extracted from PR includeRelations: true // to get blocking/related issues })

Step 3: Extract Requirements

• Parse issue description for acceptance criteria

• Check labels for feature tags

• Review comments for additional context

• Check relatedTo and blocks for dependencies

Validate PR Completeness

Check if PR addresses all requirements:

• Get issue details with mcp_Linear_get_issue

• Parse issue description for:

• Acceptance criteria (checkboxes, numbered lists)

• Feature requirements

• Technical specifications

• Compare PR changes against requirements

• Identify gaps or missing implementations

Update Issue Status

After PR review:

• Use mcp_Linear_update_issue to:

• Update status (e.g., "In Review", "Ready for QA")

• Add comments with review findings

• Link related issues

Create Review Comments

Post review findings to Linear:

mcp_Linear_create_comment({ issueId: "LIN-123", body: "## PR Review Summary\n\n✅ Requirements met: ...\n⚠️ Gaps identified: ..." })

Common Workflows

PR Review with Issue Validation

• Extract issue reference from PR title/body

• Fetch issue using mcp_Linear_get_issue

• Parse requirements from issue description

• Review PR changes against requirements

• Create comment on Linear issue with review summary

• Update issue status if needed

Issue Discovery

• List issues for a team/project using mcp_Linear_list_issues

• Filter by state, assignee, or labels

• Get details for relevant issues

• Cross-reference with PR changes

Integration with GitHub

When reviewing PRs:

• Extract Linear issue references from PR title/body

• Use Linear MCP to fetch issue requirements

• Validate PR changes against requirements

• Post review findings back to Linear issue

Reference Documentation

• MCP Functions Reference: See mcp-functions.md for function summaries and examples. The MCP server provides authoritative function definitions with complete parameter types and schemas.

• Linear API Documentation: developers.linear.app/docs