arucil/dsh-linear-mcp
A stdio MCP server for Linear with 22 issue, sub-issue, relation and comment tools, authenticated by personal API key instead of OAuth.
Exposes Linear to an MCP client with 22 tools covering issues and sub-issues, relations, comments, projects, cycles, teams, users, labels and workflow states. Lookups resolve UUIDs for teams, users, projects, cycles, labels and states; issue search takes free text or an exact identifier like ENG-4651, and listing filters by team, project, cycle, assignee (including me), state name or type, label and archived. Writes cover creating an issue including as a sub-issue, updating any mutable field including reparenting and archiving, archiving or deleting, creating and removing blocks/duplicate/related/similar relations, and commenting with threaded replies. Issue results carry both creatorId and a resolved creator object, and the README notes that a creator lookup failure is reported as an error so callers cannot infer the reporter from an assignee or comment author.
Install
dsh plugin --profile acp add github:arucil/dsh-linear-mcpThis is step 1 of the README's DSH instructions for the acp profile (swap in web or headless), and it links the server into that profile's node_modules/.bin. Step 2 is a manual edit of ~/.dsh/profiles/<profile>/cordis.patch.yml adding an mcp-linear row for @deepseek-ai/dsh-mcp-client whose command is that .bin path and whose env carries LINEAR_API_KEY; step 3 is starting a new session, because bundle patches only apply at startup. The README's other routes are npm install --global github:arucil/dsh-linear-mcp or npx --yes github:arucil/dsh-linear-mcp.
Compatibility
Needs a Linear personal API key created under Settings → Account → Security & Access, exported in the environment of the process that starts dsh — the README says explicitly not to commit it to the profile. Stdio only, one Node process, no runtime services. The author's reason for key auth over OAuth is specific: no browser round-trip, which keeps it usable in headless and ACP/Paseo-style agents where an OAuth discovery bridge would race the session's tool snapshot. Tools appear to the model as mcplinear<tool>. The README also documents mounting it in Codex and any other MCP client.
Details
- Repo: arucil/dsh-linear-mcp
- Category: Tools & Capabilities
- Stars: 0
- Version: not published to npm; installs from the GitHub default branch
Alternatives
MCviseron/dsh-eda-mcp · T-Markus-Liang/dsh-webmcp · CHplus0/dsh-learning-mode