Linear MCP Server

What is Linear MCP Server?

Linear MCP Server is a Model Context Protocol (MCP) server that provides AI assistants with access to Linear’s project management capabilities. It enables reading and writing Linear data through resources, tools, and prompt templates.

How to use Linear MCP Server?

Install Node.js 18 or later and obtain a Linear API key. Clone the repository, run npm install, create a .env file with LINEAR_API_KEY, then build with npm run build. Start the server using npm start or node dist/index.js stdio for stdio transport, or node dist/index.js http for an HTTP/SSE server on port 3000 (configurable via SERVER_PORT). To integrate with Claude Desktop, add the MCP server configuration in Claude’s settings.

Key features of Linear MCP Server

• Resources for issues, projects, teams, users, roadmaps, documents, initiatives, and more
• Tools for creating and updating issues, managing projects, and searching
• Prompts for issue creation, bug reports, and feature requests
• HTTP/SSE transport for remote connections
• Development mode with automatic reloading

Use cases of Linear MCP Server

• An AI assistant creating new issues or updating existing ones directly in Linear
• Searching across Linear entities (issues, projects, teams) using natural language
• Generating structured bug reports or feature requests via prompt templates
• Linking projects to initiatives and managing project status updates

FAQ from Linear MCP Server

What are the prerequisites for using Linear MCP Server?

Node.js 18 or later and a valid Linear API key are required.

How do I run the server in HTTP mode?

Execute node dist/index.js http; the server will start on port 3000 by default (set SERVER_PORT to change it).

Can I use this server with Claude Desktop?

Yes. After building the project, add the MCP configuration in Claude Desktop’s advanced settings, specifying the path to the built index.js and providing the Linear API key.

Is there a development mode for live reloading?

Yes, run npm run dev to start the server with automatic reloading when source files change.

What environment variables does the server support?

Required: LINEAR_API_KEY. Optional: SERVER_PORT (default 3000) and LOG_LEVEL (default info).