How to Use Linear MCP with Claude Code

What is the Linear MCP?

The Linear MCP gives Claude Code access to your Linear workspace via the Linear GraphQL API. It can create and update issues, manage projects and milestones, assign work, and search across your entire backlog — making it effortless to keep your engineering workflow synchronized with your code changes.

Installation

mcpizy install linear

Generate a Linear API key from your workspace settings under API > Personal API keys. Paste it during MCPizy installation.

Key Capabilities

• Create and update issues — open bug reports or feature requests with priority, labels, assignees, and estimates.
• Manage projects and milestones — update project status and track milestone completion.
• Search issues — find issues by keyword, status, assignee, or label across teams.
• List cycles (sprints) — see what's in the current sprint and what's been deferred.
• Add comments — post update comments on issues without leaving your editor.

Example Usage

You discover a bug while coding. Have Claude log it immediately:

// Claude creates a Linear issue:
// Title: "NullPointerException in UserService.getProfile()"
// Team: Backend
// Priority: High
// Labels: bug, regression
// Links to: current git branch

Tips and Best Practices

• Use the MCP's list_issue_statuses tool to discover your team's custom workflow states before creating issues.
• Combine with the GitHub MCP to automatically move Linear issues to "In Review" when a PR is opened.
• Use labels consistently so Claude can filter issues meaningfully — e.g., needs-design, blocked.
• The get_authenticated_user tool lets Claude assign issues to you automatically.

View on MCPizy Marketplace