mcp-server-linear-pm

thebacons/mcp-server-linear-pm

3.2

If you are the rightful owner of mcp-server-linear-pm and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Linear MCP Server provides a seamless integration solution for connecting Linear's project management tools with the Gemini CLI, ensuring compatibility and functionality across different platforms.

Tools

  1. linear-pm-progressive.js

    Complete solution with all 22 Linear tools

  2. linear-pm-minimal.js

    Fallback version with 10 safe tools

  3. linear-pm-sanitized.js

    Intermediate version with schema sanitization

  4. linear-pm-server-windows.js

    Windows-specific fixes

Linear MCP Server - Complete Integration Guide

🚀 Quick Start

This directory contains a fully working solution for integrating Linear's MCP server with Gemini CLI, solving multiple compatibility issues.

Use This Configuration:

// In your .gemini/settings.json:
{
  "mcpServers": {
    "linear": {
      "command": "node",
      "args": ["C:\\path\\to\\mcp-server-linear-pm\\linear-pm-progressive.js"],
      "cwd": "C:\\path\\to\\mcp-server-linear-pm",
      "timeout": 30000,
      "trust": false
    }
  }
}

Setup Steps:

  1. Get your Linear API key from https://linear.app/settings/api
  2. Add it to .env file: LINEAR_API_KEY=lin_api_YOUR_KEY_HERE
  3. Install dependencies: npm install
  4. Test connection: node test-linear-connection.js
  5. Restart Gemini CLI

📁 What's In This Directory

🎯 Main Solution

  • linear-pm-progressive.js - ⭐ USE THIS! Complete solution with all 22 Linear tools

🔧 Alternative Versions

  • linear-pm-minimal.js - Fallback with only 10 safe tools if you have issues
  • linear-pm-sanitized.js - Intermediate version with schema sanitization
  • linear-pm-server-windows.js - Windows-specific fixes

📚 Documentation

  • TROUBLESHOOTING.md - Detailed bug fixes and solutions
  • SETUP_GUIDE.md - Original setup instructions
  • This README - Quick reference guide

🧪 Testing

  • test-linear-connection.js - Verify your API key works

❓ Having Issues?

See TROUBLESHOOTING.md for detailed solutions to:

  • OAuth token persistence failures
  • Windows command execution errors
  • Gemini schema validation errors
  • "Connection closed" errors

✅ What Works

All 22 Linear tools are functional:

  • ✅ Read operations (list, get, search)
  • ✅ Write operations (create, update)
  • ✅ Comments, issues, projects, teams, users
  • ✅ Windows and Unix compatibility
  • ✅ No OAuth headaches - uses API key

🎉 Success!

With linear-pm-progressive.js, you get reliable Linear integration that:

  • Works across restarts (no OAuth token issues)
  • Handles all 22 Linear tools (with schema fixes)
  • Runs on Windows and Unix (platform detection)
  • Uses secure API key authentication