DesktopCommanderMCP

# Desktop Commander MCP ### Search, update, manage files and run terminal commands with AI [](https://www.npmjs.com/package/@wonderwhy-er/desktop-commander) [](https://archestra.ai/mcp-catalog/wonderwhy-er__desktopcommandermcp) [](https://smithery.ai/server/@wonderwhy-er/desktop-commander) [](https://www.buymeacoffee.com/wonderwhyer) [](https://discord.gg/kQ27sNnZr7) Work with code and text, run processes, and automate tasks, going far beyond other AI editors - while using host client subscriptions instead of API token costs. <a href="https://glama.ai/mcp/servers/zempur9oh4"> <img width="380" height="200" src="https://glama.ai/mcp/servers/zempur9oh4/badge" alt="Desktop Commander MCP" /> </a> ## Table of Contents - [Features](#features) - [How to install](#how-to-install) - [Getting Started](#getting-started) - [Usage](#usage) - [Handling Long-Running Commands](#handling-long-running-commands) - [Work in Progress and TODOs](#roadmap) - [Sponsors and Supporters](#support-desktop-commander) - [Website](#website) - [Media](#media) - [Testimonials](#testimonials) - [Frequently Asked Questions](#frequently-asked-questions) - [Contributing](#contributing) - [License](#license) All of your AI development tools in one place. Desktop Commander puts all dev tools in one chat. Execute long-running terminal commands on your computer and manage processes through Model Context Protocol (MCP). Built on top of [MCP Filesystem Server](https://github.com/modelcontextprotocol/servers/tree/main/src/filesystem) to provide additional search and replace file editing capabilities. ## Features - **Enhanced terminal commands with interactive process control** - **Execute code in memory (Python, Node.js, R) without saving files** - **Instant data analysis - just ask to analyze CSV/JSON/Excel files** - **Native Excel file support** - Read, write, edit, and search Excel files (.xlsx, .xls, .xlsm) without external tools - **PDF support** - Read PDFs with text extraction, create new PDFs from markdown, modify existing PDFs - **Interact with running processes (SSH, databases, development servers)** - Execute terminal commands with output streaming - Command timeout and background execution support - Process management (list and kill processes) - Session management for long-running commands - Server configuration management: - Get/set configuration values - Update multiple settings at once - Dynamic configuration changes without server restart - Full filesystem operations: - Read/write files (text, Excel, PDF) - Create/list directories - Move files/directories - Search files and content (including Excel content) - Get file metadata - **Negative offset file reading**: Read from end of files using negative offset values (like Unix tail) - Code editing capabilities: - Surgical text replacements for small changes - Full file rewrites for major changes - Multiple file support - Pattern-based replacements - vscode-ripgrep based recursive code or text search in folders - Comprehensive audit logging: - All tool calls are automatically logged - Log rotation with 10MB size limit - Detailed timestamps and arguments ## How to install Desktop Commander offers multiple installation methods to fit different user needs and technical requirements. > **📋 Update & Uninstall Information:** Before choosing an installation option, note that **only Options 1, 2, 3, and 6 have automatic updates**. Options 4 and 5 require manual updates. See the sections below for update and uninstall instructions for each option. ### Option 1: Install through npx ⭐ **Auto-Updates** **Requires Node.js** Just run this in terminal: ``` npx @wonderwhy-er/desktop-commander@latest setup ``` For debugging mode (allows Node.js inspector connection): ``` npx @wonderwhy-er/desktop-commander@latest setup --debug ``` **Command line options during setup:** - `--debug`: Enable debugging mode for Node.js inspector - `--no-onboarding`: Disable onboarding prompts for new users Restart Claude if running. **✅ Auto-Updates:** Yes - automatically updates when you restart Claude **🔄 Manual Update:** Run the setup command again **🗑️ Uninstall:** Run `npx @wonderwhy-er/desktop-commander@latest remove` ### Option 2: Using bash script installer (macOS) ⭐ **Auto-Updates** **Installs Node.js if needed** For macOS users, you can use our automated bash installer which will check your Node.js version, install it if needed, and automatically configure Desktop Commander: ``` curl -fsSL https://raw.githubuse