mcp-linear

mcp-linear

2
communicationdeveloper_tools

The Linear MCP Server is a Node.js-based server that enables integration with Linear issue tracking through the MCP protocol. It supports a range of functionalities such as searching, updating issues, and managing projects and comments, providing a standardized interface for interaction.

Linear MCP Server

A Node.js implementation of an MCP server for integrating with Linear issue tracking.

Key Features

  • Implements standard MCP protocol using the official MCP SDK
  • Supports searching issues, reading details, updating, and commenting
  • Provides tools for listing issues, getting issue details, listing and getting project details, adding comments, and creating issues

Getting Started

Prerequisites

  • Node.js (v18 or later)
  • Linear API key

Installation

  1. Clone the repository
  2. Install dependencies
  3. Create a .env file with your Linear API key

Running the Server

  • Start the server with npm start or use development modes with file watching and debug logging
  • Logs are written to logs/mcp-linear.log

Usage with MCP Inspector

  • Connect to the server using the web-based inspector

Troubleshooting

  • Check Linear API key validity
  • Use debug logging for detailed error information
  • Verify Linear API access permissions

Contributing

Contributions are welcome!

License

This project is licensed under the MIT License.