linear-issues
Work with Linear
Do all Linear work through the installed Linear MCP server.
Rules
-
Use the Linear MCP tools (
mcp__linear__*:list_issues,get_issue,create_issue,update_issue,list_comments,create_comment, …). Read the actual schemas before calling — Linear renames tools without notice. -
Never fall back to the GraphQL API or web UI. If no Linear MCP server is connected, stop and tell the user to add
https://mcp.linear.app/mcp(HTTP transport) to their agent. In Claude Code:claude mcp add --transport http linear https://mcp.linear.app/mcp -
Resolve names to IDs before writing. Team, state, label, and assignee fields take UUIDs; a display name fails or silently no-ops. Call the matching
list_*tool first. -
Keep comments short. 1–3 sentences. Outcome first, link the PR instead of pasting the diff, no preamble, no recap of the ticket, no sign-off, no emoji.
Root cause: config loader reads `retry_count` but the YAML key is `retryCount`, so it binds 0. Fixed in #482.