Linear MCP Server
An MCP server for interacting with Linear's API. This server provides a set of tools for managing Linear issues, projects, and teams through Cline.
Setup Guide
1. Environment Setup
- Clone the repository
- Install dependencies:
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
An MCP server for interacting with Linear's API. This server provides a set of tools for managing Linear issues, projects, and teams through Cline.
a private MCP server for accessing Linear
npm install
.env.example to .env:
cp .env.example .env
The server supports two authentication methods:
.env file:
LINEAR_API_KEY=your_api_key
.env:
LINEAR_CLIENT_ID=your_oauth_client_id
LINEAR_CLIENT_SECRET=your_oauth_client_secret
LINEAR_REDIRECT_URI=http://localhost:3000/callback
npm run build
npm start
Open your Cline MCP settings file:
~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json%APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.jsonAdd the Linear MCP server configuration:
{
"mcpServers": {
"linear": {
"command": "node",
"args": ["/path/to/linear-mcp/build/index.js"],
"env": {
"LINEAR_API_KEY": "your_personal_access_token"
},
"disabled": false,
"autoApprove": []
}
}
}
The server currently supports the following operations:
documentContent fieldThe server now properly handles Linear's rich text descriptions for projects:
description fielddocumentContent field for actual description contentLinear uses a dual-field system for descriptions:
description - Legacy field (often empty for backward compatibility)documentContent.content - Contains the actual rich text description contentThe MCP server automatically:
documentContent.content over the legacy description fieldgetProjectDescription() for consistent accessactualDescription field in responses for easy accessThe following features are currently being worked on:
# Install dependencies
npm install
# Run tests
npm test
# Run integration tests (requires LINEAR_API_KEY)
npm run test:integration
# Build the server
npm run build
# Start the server
npm start
Integration tests verify that authentication and API calls work correctly:
npm run test:integration
For OAuth testing:
.env.skip from OAuth tests in src/__tests__/auth.integration.test.tsdocumentContent field supporta private MCP server for accessing Linear
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Linear 透過 stdio 在本機執行。
上次檢查時間:2026-10-27。 a private MCP server for accessing Linear