agents-libagents-lib
AgentsMCP ServersWorkflowsTutorialsComparisonsTemplatesNewsAbout
🔌

Linear MCP

Productivity•⭐ 590

Manage Linear issues, projects, and teams for agile project management.

GitHubWebsite →
Claude DesktopCursor

Overview

Manage Linear issues, projects, and teams for agile project management.

Setup

Run with npx:

npx -y @modelcontextprotocol/server-linear

Configuration

LINEAR_API_KEY environment variable

Documentation

Linear MCP

Overview

Linear MCP provides access to Linear, the modern issue tracking and project management tool for software teams. AI agents can create, update, and query issues, manage projects, and interact with team workflows.

Features

  • Issue Management: Create, update, and query issues
  • Project Tracking: Manage projects and milestones
  • Team Context: Access team structure and members
  • Search: Find issues by title, description, or labels
  • Comments: Add and retrieve issue comments
  • Status Updates: Change issue status and assignees

Installation

npx -y @modelcontextprotocol/server-linear

Configuration

Add to your Claude Desktop config:

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-linear"],
      "env": {
        "LINEAR_API_KEY": "your-api-key"
      }
    }
  }
}

Getting API Credentials

  1. Go to Linear Settings > API
  2. Generate a personal API key
  3. Copy the key to your configuration

Available Tools

ToolDescription
search_issuesSearch for issues across teams
get_issueGet a specific issue by ID
create_issueCreate a new issue
update_issueUpdate an existing issue
list_teamsList all teams
list_projectsList projects in a team
add_commentAdd a comment to an issue

Usage Examples

Search Issues

Search for issues with title containing "bug" in team "Frontend"

Search for issues assigned to me with priority "High"

Create an Issue

Create issue with title "Fix login page crash"
Description: "Users are experiencing a crash when logging in with SSO"
Team: "Frontend"
Priority: "High"
Labels: ["bug", "urgent"]

Update an Issue

Update issue "PROJ-123" to set status to "In Progress"

Update issue "PROJ-123" to add label "needs-review"

Add a Comment

Add comment to issue "PROJ-123": "I've identified the root cause. Working on a fix."

Claude Desktop Setup

  1. Install the MCP server
  2. Add configuration to claude_desktop_config.json
  3. Restart Claude Desktop
  4. The Linear tool will appear in your available tools

Use Cases

  • AI-Powered Triage: Automatically categorize and prioritize incoming issues
  • Status Updates: Get AI to summarize progress on complex issues
  • Documentation: Generate issue descriptions from natural language
  • Meeting Prep: Summarize all open issues before sprint planning
  • Code Context: Link GitHub PRs to Linear issues automatically

Pros

  • ✅ Native Linear integration
  • ✅ Full CRUD for issues
  • ✅ Great for AI-assisted project management
  • ✅ Team and project context available
  • ✅ Real-time updates

Cons

  • ❌ Requires Linear API key
  • ❌ Limited to Linear's data model
  • ❌ No built-in GitHub integration
  • ❌ Some advanced features require Linear paid plan

Resources