Linear MCP Integration Server

This server provides Linear integration capabilities through the Model Context Protocol (MCP). It allows AI models to interact with Linear for issue tracking and project management.

Features

The server provides the following tools through the MCP interface:

linear_create_issue

Creates a new Linear issue with the following parameters:

- title (required): Issue title
- teamId (required): Team ID to create issue in
- description (optional): Issue description (markdown supported)
- priority (optional): Priority level (0-4)
- status (optional): Initial status name

linear_search_issues

Search Linear issues with flexible filtering:

- query (optional): Text to search in title/description
- teamId (optional): Filter by team
- status (optional): Filter by status
- assigneeId (optional): Filter by assignee
- priority (optional): Priority level (0-4)
- limit (optional, default: 10): Max results to return

linear_sprint_issues

Get all issues in the current sprint/iteration:

- teamId (required): Team ID to get sprint issues for

linear_search_teams

Search and retrieve Linear teams:

- query (optional): Text to search in team names

linear_filter_sprint_issues

Filter current sprint issues by status and automatically filters to the current user:

- teamId (required): Team ID to get sprint issues for
- status (required): Status to filter by (e.g. "Pending Prod Release")

linear_get_workflow_states

Get all available workflow states (statuses) for a team:

- teamId (required): Team ID to get workflow states for

linear_list_projects

Get a list of all projects available with their IDs:

- teamId (optional): Team ID to filter projects by team
- limit (optional, default: 50): Max number of projects to return

Developer Setup

1. Get your Linear API key from Linear's settings > API section

2. Copiez le fichier d'exemple d'environnement :

   cp .env.example .env
   

3. Modifiez le fichier .env et ajoutez votre clé API Linear :

   LINEAR_API_KEY=votre_clé_api_linear_ici
   

4. Install dependencies:

    npm install
    

5. Start the server:

    # Development mode with auto-reload
    npm run dev
# Production mode

    npm start
# Build TypeScript

    npm run build
# Run linter

    npm run lint
# Run tests

    npm run test
# Inspect MCP server

    npm run inspect

    

Docker Setup if project cloned from GitHub

You can also run this application using Docker:

1. Make sure you have Docker and Docker Compose installed on your system
2. Create a .env file with your Linear API key as described above
3. Build and start the container:

    # Build and start the container in detached mode
    docker-compose up -d
# View logs

    docker-compose logs -f
# Stop the container

    docker-compose down

    

4. The server will be running inside the container and will automatically restart unless explicitly stopped

Using Docker (Simplified method with docker-compose)

1. Create a .env file with your Linear API key:

   LINEAR_API_KEY=your_linear_api_key_here
   

2. Create a docker-compose.yml file:

   version: '3.8'
   
   services:
     mcp-linear-server:
       image: madebynando/mcp-linear-server:latest
       container_name: mcp-linear-server
       restart: unless-stopped
       env_file:
         - .env
       volumes:
         - ./logs:/app/logs
   

3. Start the container:

   docker-compose up -d
   

4. To configure Cursor, use:
- Transport type: command
- Command: docker exec -i mcp-linear-server node dist/server.js

Docker Development

For development with Docker:

```bash