MCP Server Linear

mcp-server-linear is an intermediate server that connects client applications with the Linear platform, providing a standardized MCP interface to access and manage Linear resources such as issues and projects. It supports two authentication methods, API Key and OAuth, includes full CRUD operations, advanced search functions, and can be integrated with multiple AI assistants.

Developer tools #Issue management #Project collaboration #API integration #AI assistant Remote .TypeScript

rating : 2 points

downloads : 8

update time : 2025-04-29

What is the Linear MCP Server?

The Linear MCP Server is an intermediate service that connects client applications (especially AI assistants) with the Linear project management platform. It provides a standardized interface to access and manipulate Linear resources, such as issues, projects, teams, etc.

How to use the Linear MCP Server?

You can use this service by configuring an API key or OAuth authentication, and then interact with it through an MCP-compatible client (such as the Cline extension for VS Code or the Cursor editor).

Use cases

Suitable for teams that need to integrate AI assistants into the Linear workflow, automate issue management, or build custom Linear integration tools.

Main features

Issue managementFull CRUD operations (create, read, update, delete) support for Linear issues, including updating labels, priorities, estimates, and statuses.

Comment managementCreate, update, and delete comments on issues, and retrieve all comments for a specific issue.

Resource accessRetrieve resource information such as projects, issue labels, and issue statuses, supporting advanced filtering and search functions.

AI assistant integrationSeamlessly integrate with AI assistants (such as Anthropic Claude) through the MCP protocol, supporting functions such as automatic approval.

Advantages and limitations

Advantages

The standardized interface simplifies interaction with the Linear API

Supports multiple authentication methods (API key and OAuth)

Seamless integration with AI assistants and development tools

Consistent error handling and response format

Limitations

Requires configuration of an API key or OAuth application

Some advanced Linear features may not be implemented yet

Requires basic command-line knowledge for initial setup

How to use

Get an API key or configure OAuth

Create an API key or register an OAuth application in the Linear settings

Set environment variables

Configure the API key or OAuth client ID and secret

Start the server

Run the server using npx

Configure the client

Add the server configuration in an MCP client such as Cline or Cursor

Usage examples

Create an issue through an AI assistantThe AI assistant can understand user requests and automatically create Linear issues

Bulk update issue statusesMove all issues marked as 'bug' and in the 'In progress' state to 'Completed'

Get an overview of project progressQuery all issues and status distributions for a specific project

Frequently Asked Questions

How to get a Linear API key?

Which MCP clients are supported?

How to debug server issues?

Is custom field support available?

Related resources

Linear official API documentation

Official documentation and reference for the Linear API

MCP protocol specification

Official specification for the Model Context Protocol

GitHub repository

Project source code and issue tracking

Cline extension

MCP client extension for VS Code

🚀 mcp-server-linear

A Model Context Protocol (MCP) server for interacting with the Linear API. This server provides tools and resources to access and manipulate Linear issues, projects, and other data through a standardized MCP interface.

🚀 Quick Start

The mcp-server-linear project serves as a bridge between client applications (especially AI assistants and other tools) and Linear, offering standardized interface access to Linear resources.

✨ Features

Standard access to Linear resources (issues, projects, initiatives, teams)
Complete CRUD operations on issues and comments
Advanced filtering and search capabilities for issues
Consistent error handling and response formats
Integration with AI assistants via the MCP protocol

📦 Installation

Install Dependencies

Install project dependencies via pnpm:

pnpm install

Start the Server

Start the MCP server:

pnpm run start

📚 Documentation

Configuration

Linear API Authentication

This server supports two authentication methods:

1. API Key Authentication

Set the LINEAR_API_KEY variable in the environment. For example:

LINEAR_API_KEY=your_api_key_here pnpm run start

2. OAuth Authentication

Configure an OAuth client and authenticate using the obtained access token.

Configuration Options

Environment Variables

LINEAR_API_KEY: Required environment variable for authentication.
PORT: Optional, defaults to 3000. Specifies the port on which the server runs.

Usage

Operation Commands

# Start the server (including debug mode)
pnpm run start -- --debug

# Define the log file path
pnpm run start -- --log-file custom.log

Architecture

This server follows the Model Context Protocol (MCP) architecture, providing a standardized way to access Linear resources. Key architectural decisions include:

Resource Organization: Organize resources by domain in separate files.
Error Handling: Consistent error handling for all resources.
Response Format: Consistent JSON response format.

For more details, refer to adr.md.

Development

# Run tests
pnpm test

# Build the project
pnpm run build

# Watch for changes
pnpm run watch

# Run in debug mode
pnpm run debug

MCP Inspector Tool

Use the MCP inspector tool to interact with the server:

Install the MCP inspector tool globally:

pnpm install -g @modelcontextprotocol/inspector

Start the inspector tool using npx:

LINEAR_API_KEY=your_api_key_here npx -y @modelcontextprotocol/inspector @mkusaka/mcp-server-linear

🤝 Contribution

Contributions are welcome! Please refer to adr.md for architectural decisions and project structure.

📄 License

MIT

Featured MCP Services

Markdownify MCP

Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.

TypeScript

1.7K

5 points

Duckduckgo MCP Server

Certified

The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.

The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.

A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.

UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.

554

5 points

Figma Context MCP

Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.

Context7 MCP is a service that provides real-time, version-specific documentation and code examples for AI programming assistants. It is directly integrated into prompts through the Model Context Protocol to solve the problem of LLMs using outdated information.

The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.

Python

745

4.8 points

Zhiqi Future, Your AI Solution Think Tank

English 简体中文繁體中文にほんご