Linear Bridge MCP

MCP server for Linear-GitHub bridge interactive mode. Provides the ask_user tool for Claude Code to communicate with users via Linear comments.

Installation

This package is installed from GitHub in the Claude Code workflow:

npm install github:QuantumSpring/qs-linear-bridge-mcp

Environment Variables

Required environment variables (set by the GitHub Action):

• QS_LINEAR_GITHUB_BRIDGE_URL - Bridge server URL
• QS_LINEAR_GITHUB_BRIDGE_CALLBACK_SECRET - Shared secret for authentication
• BRIDGE_SESSION_ID - Session ID for the current interactive session

Usage

The package is used as an MCP server in Claude Code. It provides a single tool:

ask_user

Ask the user a question via Linear comment.

Parameters:

• question (required) - The question to ask
• context (optional) - Additional context about what you've discovered

Behavior:

• Posts the question as a Linear comment
• Polls for a response (5-second intervals)
• Returns the user's response when received
• After 30 minutes, returns a timeout message

Development

npm install
npm run build