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:
Potencia tu agente
Instalación del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
Aún no hay una versión empaquetada en el registro. Sigue el README del repositorio.
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirDel publicador
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
Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
Este registro no indica ninguna variable de entorno obligatoria.
Linear se ejecuta localmente por stdio.
Última comprobación: 2026-10-27. a private MCP server for accessing Linear