Linear MCP

🚀 Linear MCP Server

A Linear Protocol (MCP) server that offers tools for linear issue tracking and project management.

🚀 Quick Start

✨ Configuration

Go to Linear Security Settings and create an API key:

Then, configure it using the LINEAR_API_KEY environment variable:

# Add to your .env file
LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

# Or export as an environment variable
export LINEAR_API_KEY=lin_api_xxxxxxxxxxxx

🚀 Running the Server

uvx --from git+https://github.com/vinayak-mehta/linear-mcp linear-mcp

🐳 Docker

docker build -t linear-mcp:latest .
docker run -it --rm -e LINEAR_API_KEY=lin_api_xxxxxx linear-mcp:latest

To use it with Claude Desktop, do as follows:

    "linear-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-it",
        "--rm",
        "-e",
        "LINEAR_API_KEY=lin_api_xxxxxx",
        "linear-mcp-server:latest"
      ]
    }

📚 Resources

The Linear MCP provides access to the following resource types:

🛠️ Tools

💻 Usage Examples

📋 Creating a New Issue

Create a new ticket: "The login screen has mysteriously disappeared like a magician at a birthday party!" Priority: High, Team: Engineering

🔄 Updating an Issue

Upgrade ENG-123 to "Meteor" priority! The user is very excited! Change the status to "In Sprint!"

🔍 Searching for Issues

Find all frontend tasks with "authentication" and in the pending state

📈 Getting User Tasks

What exciting challenges await me in Linear today?

💬 Adding a Comment

Add to DEV-456: "Put on hold for now because the API is getting a makeover. It will return in the next sprint with a fresh look!"

👥 Organization Overview

Show our amazing team structure so I can admire all the talented people

📄 License

Apache 2.0