github-mcp

The Linear-GitHub Bridge MCP Server offers a sophisticated interface between Linear issues and GitHub repositories. It features intelligent triage to ensure engineering issues are directed to GitHub for Copilot agent integration, while business/product issues remain in Linear for optimal workflow management. The server is optimized for feature development, release management, and issue management, providing seamless bidirectional synchronization and a comprehensive toolset for full issue lifecycle management across both platforms.

Features

• {'name': '🔗 Linear Integration', 'description': 'Full CRUD operations for Linear issues, team management, and support for priorities, assignees, labels, and status tracking.'}
• {'name': '🐙 GitHub Integration', 'description': 'Complete GitHub issue lifecycle management, repository integration, and full metadata synchronization.'}
• {'name': '🧠 Intelligent Triage', 'description': 'AI-powered analysis of issue content with automatic classification, confidence scoring, and label suggestions.'}
• {'name': '🔄 Bidirectional Synchronization', 'description': 'Seamless issue synchronization between platforms with context preservation and flexible sync modes.'}
• {'name': '🚀 Pull Request Management', 'description': 'Automatic creation of feature and release PRs with comprehensive descriptions and Linear issue tracking.'}

MCP Tools

• triage_issue: Analyze an issue and determine the optimal platform (GitHub for engineering, Linear for business).
• create_issue: Create an issue on GitHub or Linear based on triage decision.
• get_linear_issue / get_github_issue: Get detailed information about a specific issue.
• list_linear_issues / list_github_issues: List issues with optional filtering.
• update_github_issue: Update a GitHub issue with new information.
• sync_issue: Synchronize an issue between GitHub and Linear platforms.
• list_linear_teams: List all available Linear teams for issue creation.
• create_feature_pr: Create a feature PR from a Linear issue.
• create_release_pr: Create a release PR with change analysis.
• update_pr: Update an existing pull request.

Usage with Different Platforms

NPX (Recommended)

bash
# Set required environment variables
export GITHUB_TOKEN=your_github_personal_access_token
export LINEAR_API_KEY=your_linear_api_key

# Run the server
npx @ibraheem4/github-mcp

Local Development

bash
git clone https://github.com/ibraheem4/github-mcp.git
cd github-mcp
npm install
npm run build

Claude Desktop

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token"
      }
    },
    "linear-github-bridge": {
      "command": "npx", 
      "args": ["-y", "@ibraheem4/github-mcp"],
      "env": {
        "GITHUB_TOKEN": "your_github_personal_access_token",
        "LINEAR_API_KEY": "your_linear_api_key"
      }
    }
  }
}

Environment Variables

env
# Required for GitHub API access
GITHUB_TOKEN=your_github_personal_access_token

# Required for Linear API access  
LINEAR_API_KEY=your_linear_api_key