Navigation
Linear: Chaos Slayer & Workflow Mastery - MCP Implementation

Linear: Chaos Slayer & Workflow Mastery

Crush chaos, own your workflow. Linear’s sharp tools turn messy projects into sleek, actionable wins—no fluff, just focus. 🚀

Visit Repository
✨ Developer Tools
4.1(177 reviews)
265 saves
123 comments

31% of users reported increased productivity after just one week

About Linear

What is Linear: Chaos Slayer & Workflow Mastery?

Linear: Chaos Slayer & Workflow Mastery is an MCP (Model Context Protocol) server that integrates AI assistants with Linear’s project management platform. By leveraging Linear’s GraphQL API, this tool empowers AI systems like Claude to automate tasks, manage workflows, and maintain order in complex project environments. Instead of manual API calls, teams gain a unified interface to streamline issue tracking, team coordination, and status updates—all while reducing the chaos of fragmented systems.

How to Use Linear: Chaos Slayer & Workflow Mastery?

Getting started is straightforward:

  1. Install via Smithery for supported clients like Cursor or Claude Desktop.
  2. Configure your MCP settings with your Linear API key. For example, in Cursor’s ~/.cursor/mcp.json:
{
    "mcpServers": {
      "linear": {
        "command": "npx",
        "args": ["-y", "@beautyfree/mcp-linear"],
        "env": {
          "LINEAR_API_KEY": "your_token_here"
        }
      }
    }
  }

Once connected, issue natural-language commands like “Assign issue BE-456 to Jane Doe” or “List all unresolved bugs in the Backend project.”

Linear Features

Key Features of Linear: Chaos Slayer & Workflow Mastery

  • Seamless API Integration: Full access to Linear’s GraphQL endpoints through standardized MCP tools.
  • Granular Control: Create issues, update statuses, assign tasks, and add comments—all programmatically.
  • Team-Centric Workflows: Manage labels, projects, and teams, ensuring alignment across distributed teams.
  • Flexible Authentication: Uses Linear API keys for simplicity, avoiding complex OAuth flows.

For a full tool list, check the official documentation.

Use Cases of Linear: Chaos Slayer & Workflow Mastery

Imagine a scenario where your team faces constant chaos:

  • Emergency Bug Fix: An AI assistant automates creating a high-priority issue, assigns it to the on-call engineer, and updates stakeholders in real time.
  • Weekly Status Reports: Generate summaries of completed tasks by querying Linear data and formatting it into a digestible report.
  • Onboarding New Members: Automatically create welcome issues, assign them to mentors, and set deadlines—all without lifting a finger.

Linear FAQ

FAQ from Linear: Chaos Slayer & Workflow Mastery

Does this work with all Linear plans?
Yes, as long as you have access to Linear’s API and a valid API token.
Can I use it without Smithery?
Absolutely—manual installation via npm is fully supported, though Smithery simplifies client configuration.
What if my API key expires?
Update the LINEAR_API_KEY in your MCP settings or environment variables immediately to avoid disruptions.
Can I extend the available tools?
Yes! The project is open-source—check the development guide to contribute.

Content

MCP Linear

A Model Context Protocol (MCP) server implementation for the Linear GraphQL API that enables AI assistants to interact with Linear project management systems.

MCP Linear npm version Smithery

Features

  • Access to Linear's GraphQL API through MCP tools
  • Authentication via Linear API key
  • Retrieve and modify data related to users, teams, projects, and issues
  • Create, update and comment on issues
  • Add and remove labels
  • Create projects
  • Comprehensive documentation of available tools

Example prompts

Once connected, you can use prompts like:

  • "Show me all my Linear issues"
  • "Create a new issue titled 'Fix login bug' in the Frontend team"
  • "Change the status of issue FE-123 to 'In Progress'"
  • "Assign issue BE-456 to John Smith"
  • "Add a comment to issue UI-789: 'This needs to be fixed by Friday'"

Installation

Installing via Smithery (Recommended)

  • To install MCP Linear for Cursor:

    npx -y @smithery/cli install @beautyfree/mcp-linear --client cursor

  • To install MCP Linear for Claude Desktop:

    npx -y @smithery/cli install @beautyfree/mcp-linear --client claude

Manual Configuration

After installation, add the following to your MCP settings file:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@beautyfree/mcp-linear"],
      "env": {
        "LINEAR_API_KEY": "your_linear_api_key_here"
      }
    }
  }
}

Client-Specific Configuration Locations

  • Cursor: ~/.cursor/mcp.json
  • Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Claude VSCode Extension: ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
  • GoMCP: ~/.config/gomcp/config.yaml

Manual Installation

  1. Clone the repository
git clone https://github.com/beautyfree/mcp-linear.git
cd mcp-linear
  1. Install dependencies
npm install
  1. Build the project
npm run build
  1. Create a .env file with your Linear API token
LINEAR_API_KEY=your_linear_api_key_here
  1. Start the server
npm start

Available Tools

See TOOLS.md for a complete list of available tools and planned features.

Overview

MCP Linear bridges the gap between Claude (AI assistant) and Linear (project management tool) by implementing the MCP protocol. This allows Claude to:

  • Retrieve issues, projects, teams, and other data from Linear
  • Create and update issues
  • Change issue status
  • Assign issues to team members
  • Add comments
  • Create projects and teams

The server uses Linear's GraphQL API and authenticates via user tokens (not OAuth) for simplicity.

Getting Started

Prerequisites

  • Node.js (v18+)
  • NPM or Yarn
  • Linear API token

Installation

# Install globally
npm install -g @beautyfree/mcp-linear

# Or clone and install locally
git clone https://github.com/beautyfree/mcp-linear.git
cd mcp-linear
npm install
npm link  # Makes the package available globally

Running the Server

Run the server with your Linear API token:

mcp-linear --token YOUR_LINEAR_API_TOKEN

Or set the token in your environment and run without arguments:

export LINEAR_API_TOKEN=YOUR_LINEAR_API_TOKEN
mcp-linear

Development

See DEVELOPMENT.md for more information on how to develop locally.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Related MCP Servers & Clients

mcp-linearproject-management

Quick Navigation

MCP Categories

Developer Tools