Hash-anchored file edits for MCP clients. Rejects stale writes before they happen.
Most developer tooling work still happens through a UI a human drives. Hledit MCP MCP server moves it into the conversation instead. Hash-anchored file edits for MCP clients. Rejects stale writes before they happen.
hledit-mcp is an MCP server exposing hledit's hash-anchored file edits to standard MCP clients such as Claude Code, Claude Desktop, and Cursor.
The server publishes 14 tools. What each one is for:
Variable — DefaultHLEDIT_BIN — hledit (on PATH)HLEDIT_CWD — server's process.cwd()HLEDIT_MCP_DIFF — 0HLEDIT_MCP_DIFF_MAX_LINES — 80HLEDIT_MCP_DIFF_CONTEXT — 2HLEDIT_MCP_DIFF_MAX_CELLS — 40000read — Read annotated lines with LN#HASH anchorsedit — Apply a single replace/insert/delete/replace-rangebatch — Apply multiple anchor-referenced edits in one callpath — stringoffset — numberThe server ships on npm as hledit-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.
Configuration is passed through the environment: HLEDIT_CWD. Treat anything key-shaped as a real credential — scope it to the minimum the server needs, and rotate it if it ever lands in a shared config.
hledit CLI (or a prebuilt binary on PATH) - Node.js 18+ - An MCP-compatible clientThis sits in the developer tooling group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Hledit MCP's toolset — Variable, HLEDIT_BIN, HLEDIT_CWD and 11 more — is a fair guide to whether it matches your workflow. It is maintained by dabito; worth a glance at recent repository activity before you build anything load-bearing on it.
We check each listing at SyncDev against the project's documentation before it goes live — if something here drifts out of date, it is a bug worth reporting.
| Tool | What it does |
|---|---|
| Variable | Default |
| HLEDIT_BIN | hledit (on PATH) |
| HLEDIT_CWD | server's process.cwd() |
| HLEDIT_MCP_DIFF | 0 |
| HLEDIT_MCP_DIFF_MAX_LINES | 80 |
| HLEDIT_MCP_DIFF_CONTEXT | 2 |
| HLEDIT_MCP_DIFF_MAX_CELLS | 40000 |
| read | Read annotated lines with LN#HASH anchors |
| edit | Apply a single replace/insert/delete/replace-range |
| batch | Apply multiple anchor-referenced edits in one call |
| path | string |
| offset | number |
| limit | number |
| context | number |
{
"mcpServers": {
"hledit": {
"command": "npx",
"args": ["-y", "hledit-mcp"],
"env": {
"HLEDIT_CWD": "your-value"
}
}
}
}Add to claude_desktop_config.json, then restart Claude Desktop.
hledit CLI (or a prebuilt binary on PATH) - Node.js 18+ - An MCP-compatible client| Variable | Description | Required |
|---|---|---|
| HLEDIT_CWD | Configuration value read at startup. | Optional |
Kill hallucinated APIs — version-accurate, up-to-date library documentation injected straight into context.
Microsoft's official browser automation server — drive a real browser through the accessibility tree, no screenshots needed.
GitHub's official server — repos, issues, pull requests, Actions and code security, straight from your assistant.
Issue tracking at the speed of conversation — Linear's official hosted server with OAuth and zero install.
Local repository surgery — status, diffs, commits, branches and history for any repo on disk.
Timezone sanity for AI — current time anywhere and correct conversions, without the model doing date math.