mcp-linear
Author: tacticlaunch
Description: Model Context Protocol (MCP) server that connects AI assistants to Linear’s GraphQL API, enabling creation, retrieval and management of issues, projects and teams via natural-language prompts.
Stars: 96
Forks: 13
License: MIT License
Category: Specialized
Overview
Installation
Prerequisites:
• Node.js >= 18
• A Linear personal API key with read-write permissions
• (Optional) Docker if you prefer containerised deployment
1. Clone the repository
git clone https://github.com/tacticlaunch/mcp-linear.git
cd mcp-linear2. Install dependencies
npm install
# or
yarn install3. Configure environment variables
cp .env.example .env
# Open .env and set at minimum:
LINEAR_API_KEY="<your-linear-token>"
MCP_PORT=8080 # Port the MCP server will listen on (default 8080)
LOG_LEVEL=info # Optional4. Build the TypeScript source code
npm run build # transpiles to ./dist5. Start the server
-------
npm start # runs node dist/index.js
# or hot-reload in dev mode
npm run dev # uses ts-node + nodemon
Docker
docker build -t mcp-linear .
docker run -e LINEAR_API_KEY=<token> -p 8080:8080 mcp-linear
The server is now reachable at http://localhost:8080 .License: MIT License
Updated 7/30/2025