# DesktopCommanderMCP

> This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities

- **URL**: https://www.freshcrate.ai/projects/DesktopCommanderMCP
- **Author**: wonderwhy-er
- **Category**: MCP Servers
- **Latest version**: `v0.2.42` (2026-06-05)
- **License**: MIT
- **Source**: https://github.com/wonderwhy-er/DesktopCommanderMCP
- **Homepage**: https://desktopcommander.app/
- **Language**: TypeScript
- **GitHub**: 5,928 stars, 694 forks
- **Registry**: github
- **Tags**: `agent`, `ai`, `code-analysis`, `code-generation`, `mcp`, `terminal-ai`, `terminal-automation`, `typescript`, `vibe-coding`

## Description

This is MCP server for Claude that gives it terminal control, file system search and diff file editing capabilities

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.2.42` | 2026-06-05 | High | - 🖼️ **Image reads fixed** — on some clients the model wasn't actually seeing the image when reading an image file; it does now. [#488](https://github.com/wonderwhy-er/DesktopCommanderMCP/pull/488)  - 🪟 **Windows: terminal command quoting fixed** — some types of commands had their quotes mangled before running; fixed now. [#495](https://github.com/wonderwhy-er/DesktopCommanderMCP/pull/495)  - 🪟 **Windows: PATH fixes** — DC now correctly finds tools and apps that are installed and on your |
| `v0.2.41` | 2026-05-14 | High | ## 🔒 Security: directory traversal via symlink bypass — fixed  A symlink inside an allowed directory pointing to a restricted location could bypass `isPathAllowed()` when the target file didn't yet exist — `fs.realpath()` failed with `ENOENT` and the allowlist check fell back to the unresolved path. `validatePath()` now resolves the deepest existing ancestor and reconstructs the real path before checking the allowlist, so a symlink at `/projects/evil → /etc/` can no longer trick a write of `/ |
| `v0.2.40` | 2026-04-27 | High | ## 🛟 Hotfix: Markdown auto-save no longer corrupts your files  If you've been on **v0.2.39**, please upgrade. The markdown preview pane was silently rewriting `.md` files on disk through a Tiptap round-trip — collapsing GFM tables, rewriting Obsidian wikilinks (`[[Note]]` → `[Note](http://Note)`), corrupting YAML frontmatter, and adding spurious `\[`, `\]`, `\~`, `\_` escapes. Fixed in __[#445](https://github.com/wonderwhy-er/DesktopCommanderMCP/pull/445)__ — closes __[#437](https://github.co |
| `v0.2.39` | 2026-04-23 | High | ## 📝 Markdown Editor (New!) WYSIWYG markdown editing right in the preview pane — what you see is what you get. Edit your .md files, then copy-paste the formatted output straight into Slack, Medium, Notion, email, or anywhere else that accepts rich text. No more "does **this** work here or do I need to retype it as bold?"  <img width="387" height="424" alt="Screenshot 2026-04-23 at 14 41 39" src="https://github.com/user-attachments/assets/a79eefad-ccc5-4626-8861-a8c7920d6227" /> <img width=" |
| `v0.2.38` | 2026-03-03 | Low | 🖥️ Settings Panel (New!) A visual config editor right inside Claude Desktop — no more editing JSON files or remembering tool call syntax. <img width="739" height="657" alt="image" src="https://github.com/user-attachments/assets/fb6aa42b-a2f5-42dc-aac9-3c100c03c109" />  View and edit all Desktop Commander settings through a clean UI Toggle telemetry, adjust file limits, manage blocked commands and allowed directories Dark mode support with host-agnostic theming Works across different MCP |
| `v0.2.37` | 2026-02-20 | Low | ## 📄 DOCX Support (New!) Full Microsoft Word document support through the existing `read_file`, `write_file`, `edit_block`, and `start_search` tools — no new tools needed.  * **Read DOCX** — default mode shows a text-bearing outline (paragraphs, tables, images, headers/footers) with body indices for navigation. Set `offset=1` to get raw pretty-printed XML for precise editing. * **Edit DOCX** — surgical find/replace on the underlying XML via `edit_block`, with automatic header/footer search |
| `v0.2.36` | 2026-02-16 | Low | ## 🖼️ File Preview UI (New!)  When Claude reads a file, you now get a **visual preview widget** right in Claude Desktop — no more staring at raw text dumps in the chat.  - **Rendered markdown** with clean, Medium-inspired typography - **Image preview** — PNG, JPEG, GIF, WebP files render inline - **"Load more lines"** — expand before/after to see more of the file without re-reading - **Breadcrumb path** with an **"Open in folder"** button to jump straight to the file in Finder/Explorer |
| `v0.2.33` | 2026-02-01 | Low | ## Security - Fix command blocklist bypass via absolute paths and command substitution — thanks @dcpagotto  - `validatePath` now blocks symlink traversal to prevent arbitrary read/write — thanks @zjyhhhher  - Added symlink security tests for `validatePath`  ## Protocol - Use SDK protocol version negotiation instead of a hardcoded version (found and suggested by @abcnow)  ## Features - Add v2 feature flags with weighted A/B test variants - Fix welcome page A/B test to include local-agen |
| `v0.2.30` | 2026-01-21 | Low | ## 🚀 Major New Feature  ### Remote MCP - Use Desktop Commander from ChatGPT & Claude Web! (#311)  You can now use Desktop Commander directly from **ChatGPT**, **Claude web**, and other AI services - no Claude Desktop app required!  **How it works:** 1. Run the Remote Device on your computer: `npx @wonderwhy-er/desktop-commander@latest remote` 2. Authenticate in your browser (secure OAuth 2.0 flow with PKCE) 3. Connect your AI at [mcp.desktopcommander.app](https://mcp.desktopcommander.a |
| `v0.2.24` | 2025-12-17 | Low | ## 🚀 Major New Features  ### Full PDF Support (#283) Desktop Commander now has comprehensive PDF capabilities - read, create, and modify PDF files directly.  **Reading PDFs:** - Extract text content as markdown with page structure - Extract embedded images from PDFs - Page-based pagination (offset/length work as page numbers) - Performance optimized for partial page reading  **Creating PDFs:** - Convert markdown to PDF with `write_pdf` tool - Supports headers, lists, code blocks, t |

## Dependency audit

- **Score**: 98/100
- **Total deps**: 42
- **Resolved**: 42
- **Unresolved**: 0
- **License conflicts**: 0
- **Warnings**: 1
- **Scanned**: 2026-04-27

## Citation

- HTML: https://www.freshcrate.ai/projects/DesktopCommanderMCP
- Markdown: https://www.freshcrate.ai/projects/DesktopCommanderMCP.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/DesktopCommanderMCP/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._
