skills.rest
ZawilecxD
ZawilecxDCOMMUNITY
Explore all skills by this author →
GitHub

linear-mcp

Manages Linear issues, projects, cycles, and documents through MCP tools.

Updated May 20, 2026
Search Tags:#project management#mcp#roadmap#issue tracking#sprint planning#linear#backlog triage
One-click install
npx skills add https://github.com/ZawilecxD/trAInR --skill linear-mcp-zawilecxd
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: linear-mcp
Source: https://github.com/ZawilecxD/trAInR/tree/main/.cursor/skills/linear-mcp
Command: npx skills add https://github.com/ZawilecxD/trAInR --skill linear-mcp-zawilecxd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Coordinating planning work in Linear requires knowing the correct MCP server, tool names, parameter conventions, and workspace identifiers, and mistakes like wrong team names or escaped markdown cause failed or malformed operations. ## Core Features & Use Cases - Issue Lifecycle Management: Create, update, search, and comment on Linear issues with correct team, project, state, priority, and relation fields. - Planning Structures: Work with projects, milestones, cycles, labels, and Linear documents to organize roadmap slices and sprints. - Repo-Aligned Conventions: Map trAInR roadmap slices and change plans to Linear issues, link GitHub PRs, and delegate work to the Linear agent. - Use Case: After merging a GitHub PR, ask the assistant to move the linked Linear issue to in review, attach the PR URL, and post a test-plan checklist comment. ## Quick Start Ask the assistant to create a Linear issue for the current roadmap slice in the trAInR project with a description and test plan.

Frequently Asked Questions about linear-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Linear issue with MCP tools?▼

Call save_issue without an id, providing title and team at minimum, plus optional project, state, priority, labels, assignee, and links. First run list_teams and list_issue_statuses so the team and state values are valid for the workspace.

How do I update an existing Linear issue?▼

Call save_issue with the issue id, either a UUID or an identifier like TRA-123, and pass only the fields you want to change. Relation fields such as blocks and links are append-only unless you use the explicit remove parameters.

Can I link GitHub PRs to Linear issues?▼

Yes, add the PR URL through the links field on save_issue with a url and title. The recommended flow is to update the issue state to in review and add a comment with the test-plan checklist after opening the PR.

Why does my Linear MCP tool call fail with invalid team or state?▼

The team or state value does not match the workspace configuration. Re-run list_teams and list_issue_statuses to get valid identifiers, and confirm the server id is user-Linear with the Linear plugin authenticated.

How do I assign work to the Linear agent instead of a person?▼

Set the delegate field on save_issue, or filter list_issues by delegate, to target Linear's app user. Use the assignee field only for human owners, since delegate and assignee map to different entity types.

Related Skills

Explore More Product & Management Skills→
microsoftmicrosoft
10

outcome-cartographer

Review product plans for missing outcome mapping and unmeasured success criteria.

Official
Intermediate
dodevprojectdodevproject

pr

Create GitHub pull requests with gitmoji titles and linked issues.

Community
Advanced
sori883sori883

github-workflow

Manage GitHub repositories, branches, commits, pull requests, and issues with Linear integration.

Community
Advanced
ma08ma08
28

linear

Manage issues, projects, and team workflows in Linear.

Community
Intermediate