================== /// MCP /// /// MCP /// ================== [server:online] [protocol:ready]
mcp-linear
by tacticlaunch
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.
96
13
SpecializedInstallation
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-linear
2. Install dependencies
npm install
# or
yarn install
3. 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 # Optional
4. Build the TypeScript source code
npm run build # transpiles to ./dist
5. 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 .
Documentation
License: MIT License
Updated 7/30/2025