Linear MCP Server

A Model Context Protocol (MCP) server that provides seamless integration with Linear for project and issue management.

🚀 Features

Project Management

• ✅ Create Projects - Create new Linear projects with custom names, descriptions, priorities, and content

• ✅ List Projects - Get all projects in your workspace with detailed information

• ✅ View Project Details - Retrieve comprehensive information about specific projects

• ✅ Delete Projects - Remove projects from your workspace

Issue Management

• ✅ Create Issues - Create new issues with titles, descriptions, priorities, and project assignments

• ✅ List Issues - View all issues assigned to you

• ✅ Delete Issues - Remove issues from your workspace

• ✅ Auto-Assignment - Issues are automatically assigned to the current user

Team & User Management

• ✅ Get Team Info - View information about your Linear teams

• ✅ Get Current User - Display information about the authenticated user

• ✅ Default Team - Automatically uses your default team for operations

Related MCP server: Linear MCP Server

🛠️ Available Tools

Project Tools

• create-project - Create a new Linear project

• get-all-project - List all projects

• view-project-detail - Get detailed project information

• delete-project - Delete a project by ID

Issue Tools

• create-issue - Create a new issue

• get-all-issues - List all assigned issues

• delete-issue - Delete an issue by ID

Team & User Tools

• get-team-info - Get team information

• current-user - Get current user information

📋 Prerequisites

• Node.js (v16 or higher)

• npm or yarn

• Linear API key

🔧 Installation

1. Clone the repository:

git clone https://github.com/TechAIInsights/linear-mcp-server.git
cd linear-mcp-server

2. Install dependencies:

npm install

3. Set up environment variables:

# Create a .env file
echo "LINEAR_API_KEY=your_linear_api_key_here" > .env

4. Get your Linear API key:

   • Go to Linear Settings > API

   • Generate a new API key

   • Add it to your .env file

🚀 Usage

Development Mode

npm run dev

Production Build

npm run build
npm start

📁 Add server config

{
  "mcpServers": {
    "linear-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/repo/dist/index.js"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

💡 Usage Examples

Creating a Project

# Create a project with basic info
create-project "My New Project"

# Create a project with full details
create-project "Advanced Project" --description "A complex project" --priority "high" --content "Project details here"

Creating an Issue

# Create a basic issue
create-issue "Fix authentication bug"

# Create an issue with priority and project
create-issue "Implement new feature" --priority 2 --projectId "proj_123"

Managing Projects

# List all projects
get-all-project

# View project details
view-project-detail --id "proj_123"

# Delete a project
delete-project --id "proj_123"

🔧 Configuration

Environment Variables

• LINEAR_API_KEY - Your Linear API key (required)

Priority Levels

• 0 - No priority

• 1 - Urgent

• 2 - High

• 3 - Normal

• 4 - Low

🏗️ Architecture

The server is built with a modular architecture for maintainability:

• Modular Tools - Each tool category has its own module

• Standardized Responses - Consistent response format across all tools

• Error Handling - Comprehensive error handling with context-aware messages

• Type Safety - Full TypeScript support with proper type definitions

📚 Development Scripts

• npm run build - Compile TypeScript to JavaScript

• npm run start - Run the compiled application

• npm run dev - Run with hot reload (HMR)

• npm run dev:watch - Run with TypeScript compilation + nodemon

• npm run watch - Watch for changes and recompile automatically

• npm run test - Run tests with Jest

• npm run clean - Remove compiled output

🔗 Related

• Linear API Documentation

• Model Context Protocol

• TypeScript