Linear Integration MCP Server

Developer ToolsTypeScript

Integrate Linear's project management system with LLMs

Available Tools

linear_create_issue

Create a new Linear issue with specified title, team, and optional parameters like description, priority, and status

titleteamIddescriptionprioritystatus

linear_update_issue

Update an existing Linear issue by ID with new title, description, priority, or status

idtitledescriptionprioritystatus

linear_search_issues

Search Linear issues with flexible filtering by query text, team, status, assignee, labels, priority, and result limit

queryteamIdstatusassigneeIdlabelsprioritylimit

linear_get_user_issues

Get issues assigned to a specific user or the authenticated user, with options to include archived issues

userIdincludeArchivedlimit

linear_add_comment

Add comments to Linear issues with support for markdown and optional custom username and avatar

issueIdbodycreateAsUserdisplayIconUrl

The Linear Integration MCP server provides a seamless connection between Linear's issue tracking system and large language models. It enables AI assistants to create, update, search, and comment on Linear issues directly, making project management workflows more efficient. With this integration, users can leverage natural language to manage their Linear projects, allowing for quick issue creation, status updates, and team collaboration without leaving their AI assistant interface. The server supports comprehensive access to Linear's functionality including issue management, team views, and user assignments.

Overview

The Linear Integration MCP server connects Linear's project management system with AI assistants, allowing you to manage your Linear issues through natural language conversations.

Note: The original repository is now deprecated in favor of the official Linear MCP server at https://mcp.linear.app/sse.

Installation

Prerequisites

Before installing the Linear MCP server, you'll need:

A Linear account with an API key
An AI assistant that supports the Model Context Protocol (like Claude Desktop)

Getting a Linear API Key

Go to your Linear team settings: https://linear.app/YOUR-TEAM/settings/api
Create a new API key with appropriate permissions
Copy the API key for use in the configuration

Configuration

To set up the Linear MCP server in Claude Desktop:

Locate your Claude Desktop configuration file:
- MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Add the following configuration to the file:

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

Replace your_linear_api_key_here with your actual Linear API key
Save the file and restart Claude Desktop

Alternative Installation with Smithery

If you're using Smithery, you can install the Linear MCP server with a single command:

npx @smithery/cli install linear-mcp-server --client claude

Usage Examples

Here are some example prompts you can use with Claude Desktop to interact with Linear:

"Show me all my high-priority issues" - This will find issues assigned to you with high priority
"Create a bug report for the authentication system" - Creates a new issue with appropriate details
"Find all in-progress frontend tasks" - Searches for frontend-related issues with "in progress" status
"Give me a summary of recent updates on the mobile app development issues" - Fetches and summarizes recent activity
"What's the current workload for the mobile team?" - Analyzes issue distribution across the team

Resources

The Linear MCP server provides several resource URLs that can be used to access Linear data:

linear-issue:///{issueId} - View individual issue details
linear-team:///{teamId}/issues - View team issues
linear-user:///{userId}/assigned - View user's assigned issues
linear-organization: - View organization info
linear-viewer: - View current user context

These resources can be referenced in conversations with your AI assistant to retrieve specific information from Linear.