explaingit

wiklob/linear-mcp-lean

Analysis updated 2026-05-18

0TypeScriptAudience · developerComplexity · 3/5Setup · easy

TLDR

A self hosted MCP server for Linear that trims responses to a fraction of the size, saving AI agents tokens on every call.

Mindmap

mindmap
  root((repo))
    What it does
      Wraps Linear MCP
      Trims response fields
      Returns minimal write acks
    Tech stack
      TypeScript
      Node.js
      Express
      GraphQL
    Use cases
      Replace hosted Linear MCP
      Local stdio agent server
      Shared HTTP deploy
    Audience
      Developers
      AI agent builders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Replace Linear's hosted MCP server with a drop-in one that returns much smaller, field-trimmed responses to save tokens.

USE CASE 2

Run a local stdio MCP server for Claude Code or another AI agent to read and write Linear issues cheaply.

USE CASE 3

Deploy a shared HTTP MCP server so multiple machines and agents can query Linear through one endpoint.

What is it built with?

TypeScriptNode.jsExpressGraphQL

How does it compare?

wiklob/linear-mcp-lean0xkinno/astraea0xkinno/halcyon
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyeasyhardhard
Complexity3/54/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires Node 20+ and a personal Linear API key, HTTP mode additionally needs a bearer token for the shared deploy.

In plain English

linear-mcp-lean is a self hosted connector that lets AI agents like Claude Code talk to the project management tool Linear, using a standard called MCP that lets AI assistants call external tools. It sits in front of the same connector Linear itself offers, but it trims down what comes back from each request so an AI model reads far fewer words for the same task. The problem it solves is that Linear's own hosted connector returns full, bulky objects for every request, and every extra piece of returned data is something the AI model has to read and pay for in tokens, which adds up quickly across an agent session that might call these tools hundreds of times. This project rewrites each read so it only returns the fields an agent actually uses, shrinking a typical issue from around one kilobyte down to a few hundred bytes, and it makes write actions return a small receipt confirming what changed instead of echoing the whole updated item back. The tool names stay identical to Linear's own connector, so a workflow that already works can switch over without any other changes. If more detail is needed for a specific call, a user can ask for the full untrimmed response, or fall back to writing a raw query in the underlying data language directly, so trimming responses never becomes a dead end. The project also logs every call it makes so a person can check the actual measured savings on their own traffic through a built in statistics endpoint, rather than trusting a marketing claim. It authenticates with a simple personal access key from Linear rather than a more complex login flow, which makes it easy to run unattended in places like scheduled jobs or shared servers used by multiple automated agents. It can run locally as a single command with no server required, or be deployed once as a shared web service that multiple machines and agents can use at the same time. It requires a fairly recent version of Node.js and a personal Linear API key to get going, and is aimed at developers building or running AI coding agents that already talk to Linear and want to cut down on wasted cost.

Copy-paste prompts

Prompt 1
Help me set up linear-mcp-lean as a local stdio MCP server for Claude Code.
Prompt 2
Explain how linear-mcp-lean trims Linear API responses compared to the hosted MCP server.
Prompt 3
Walk me through deploying linear-mcp-lean as a shared HTTP server with a bearer token.

Frequently asked questions

What is linear-mcp-lean?

A self hosted MCP server for Linear that trims responses to a fraction of the size, saving AI agents tokens on every call.

What language is linear-mcp-lean written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, Express.

How hard is linear-mcp-lean to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is linear-mcp-lean for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.