Skip to main content
Glama
ch-raph

Linear Cache MCP

by ch-raph

Linear Cache MCP

npm version license: MIT

A cache-first MCP server for Linear that lets coding agents read from a local JSON cache instead of burning through API request budgets on every query.

What it does

  • 13 MCP tools — search, read, create, update, and comment on Linear issues and projects

  • Local JSON cache — fast planning reads with zero API cost

  • Request budget tracking — prevents accidentally blowing through Linear's API rate limits

  • Write-through safety — live-fetches entities before mutating, patches cache after writes

  • Project-first model — issues live inside projects; projects hold durable context

Why cache-first?

Linear's API has rate limits. Coding agents that query Linear directly for every context read can exhaust them quickly. This server maintains a local mirror of your team's issues and projects, serves reads from cache when fresh, and only hits the Linear API for writes or when the cache is stale.

Quick start

npx linear-cache-mcp

Or for development:

cd packages/linear-cache-mcp
npm install
cp .env.example .env  # add your LINEAR_API_KEY
npm test
npm start

Full setup instructions are in the package README, including Pi coding agent integration.

Structure

Path

Purpose

packages/linear-cache-mcp/

MCP server

skills/linear-ops/

Agent skill template for Linear workflows

examples/pi-project/

Ready-to-copy configs for Pi projects

examples/generic-project/

Generic MCP client config template

License

MIT

A
license - permissive license
-
quality - not tested
-
maintenance - not tested

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ch-raph/linear-cache-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server