Linear MCP Server Configuration & Usage Guide

Supported Clients

• Claude Desktop
• Cursor

Installation Command

npx -y linear-mcp-server

Configuration Example

{
  "mcpServers": {
    "linear": {
      "command": "npx",
      "args": [
        "-y",
        "linear-mcp-server"
      ],
      "env": {
        "LINEAR_API_KEY": "<your-api-key>"
      }
    }
  }
}

Environment variable required：LINEAR_API_KEY。Do not commit these values to public repositories.

Permission Scope & Security Notes

可创建和修改 Linear Issue，建议使用只读 Token 进行测试

• network-access
• credential-required

Risk Score：4/10

Common Errors

API Key 无效

在 Linear Settings > API 中生成 Personal API Key

Sources

• Official Documentation / Repository

Recently Verified：2026-05-18。Client versions and configuration formats may change. Please refer to official documentation before use.

Related Tools