linear

Prerequisites: ensure you have Node.js (v14+ recommended) and npm installed. Obtain a Linear API key to authorize requests to the Linear API. Start the server using the mcp_config specification for the linear server. The MCP server exposes tools such as list_issues, create_issue, get_issue, update_issue, and more for comprehensive issue management. You can construct a pipeline to orchestrate multiple tools—for example, listing issues to determine a follow-up action, then conditionally creating a new issue with a transform step that prepares the payload from the prior results. Use the error handling format described in the documentation to gracefully handle retryable and non-retryable errors, and monitor metrics to observe tool reliability and latency across endpoints.

1. Prerequisites

• Node.js v14 or newer
• npm or yarn
• Access to a Linear API key

2. Clone the repository

• git clone https://github.com/your-org/kablewy-linear-mcp-server.git
• cd kablewy-linear-mcp-server

3. Install dependencies

• npm install

4. Configure environment

• Create a .env file (or set environment variables) with: LINEAR_API_KEY=your_linear_api_key LINEAR_API_BASE_URL=https://api.linear.app PORT=3000

5. Build the server (if using TypeScript sources)

• npm run build

6. Run the server

• npm start

7. Verify

• Send a test request to http://localhost:3000/tool/list_issues with appropriate payloads to confirm the server is responding.

• Ensure your LINEAR_API_KEY has the necessary scopes for the operations you intend to perform (read/write as needed).
• The server uses Zod schemas for runtime validation. If you see validation errors, double-check input field names and types against the tool definitions in the README.
• For production deployments, consider configuring proper TLS termination and rotating API keys regularly.
• The execute_pipeline feature enables conditional tool orchestration and data transformation; you can customize pipelines to enforce business rules and automate workflows.