Workfile MCP Server

by illodev Your server? Claim it

local only

Workfile runs on your own machine — the client starts it, so there is no endpoint to ping. 1 308 installs a week from npm. Last commit 15 Sep 2026.

Repository-native protocol and local MCP server for Work, Docs, History and durable project Memory.

Installs per day peak 626 · avg 91 · +411% w/w

a month agotoday

1 308

Installs / week

npm · @illodev/workfile

Stars

0 open issues

15 Sep 2026

Last commit

0 releases in 90 days

MIT

License

TypeScript

What the code does

We read the source, 20 h ago · rules 3dff92dd89df

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] project.config.example.mjs:1

этот файл ставится пользователю, но в репозитории его нет

Runs an external command packages/workfile/src/modules/cards/runner.ts:210

        const child = spawn(argv[0], argv.slice(1), {

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add workfile -- npx -y @illodev/workfile

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "workfile": {
      "args": [
        "-y",
        "@illodev/workfile"
      ],
      "command": "npx"
    }
  }
}

~/.codex/config.toml

[mcp_servers.workfile]
command = "npx"
args = ["-y", "@illodev/workfile"]

.cursor/mcp.json

{
  "mcpServers": {
    "workfile": {
      "args": [
        "-y",
        "@illodev/workfile"
      ],
      "command": "npx"
    }
  }
}

.vscode/mcp.json

{
  "mcpServers": {
    "workfile": {
      "args": [
        "-y",
        "@illodev/workfile"
      ],
      "command": "npx"
    }
  }
}

Alternatives to Workfile

same job, measured the same way

Seojeom MCP

by seojeom

Local-first MCP server for Claude/Codex project wiki and graph workflows

local only

DevTime

by shakargy

Local-first, read-only MCP server for evidence-backed repository memory.

491 installs/wk local only

Repo Test Architect

by repoassay

Audit-first test strategy MCP server for repository-native test planning.

63 installs/wk local only

Yuque MCP

by wwwwujl

Yuque MCP server with safe read/write tools for groups, group members, repositories, docs, and TOC.

37 installs/wk local only

AI Context

by vibgrate

Local-first MCP server: version-correct library docs, code map, and offline drift for your repo.

2 213 installs/wk local only

Nexusmem

by yaminbkk

Local-first memory for AI coding agents: shell history with exit codes, git diffs, docs, MCP.

329 installs/wk local only

MCP Abap Adt

by fr0ster

MCP server for SAP ABAP ADT: repository analysis and CRUD for RAP and classic ABAP

615 installs/wk local only

logbook-mcp

by abduljabbarbxr

Project memory across sessions for AI agents. A queryable decision log in the repo.

520 installs/wk local only

Workfile — questions

Answers built from our own checks of this server.

Why is there no uptime for Workfile?

Workfile runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package @illodev/workfile was installed 1 308 times last week.

How do I connect Workfile?

Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls @illodev/workfile straight from npm; nothing to host, nothing to sign up for.

How many people use Workfile?

The npm package @illodev/workfile was installed 1 308 times in the last week. Week over week that is +411%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Workfile open source?

Yes — it is published under the MIT licence, written in TypeScript and 3 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.