Your personal
AI Full Stack Engineer 
with Claude Desktop

Your personal
AI Full Stack Engineer
with Claude Desktop

Work with code and text, run processes, and automate tasks using Claude Desktop's subscription model - no per-token API charges.

All of your AI development tools in one place

No need to buy separate tools for coding, file access, terminal commands, DevOps, and automation. Desktop Commander puts it all in one chat.

Local file storage and processing

All your files remain safely on your local machine. Only the necessary data is sent to Claude's LLM for processing and analysis.

Subscription-based usage

Use your Claude Desktop subscription instead of paying per API token. Daily usage limits depend on your plan tier (Pro: 45 messages/5hrs, Max: higher limits). Much more cost-effective than API pricing for regular development work.

Smart file system integration

Claude understands your project structure with intelligent file search and can make precise surgical changes to your codebase. Now supports reading from file end with negative offsets.

Interactive code execution

Execute Python, Node.js, R code in memory for instant data analysis. Connect to SSH, databases, and maintain persistent sessions for complex workflows.

Cross-platform compatibility

Works seamlessly across Windows, macOS, and Linux with native support for each operating system's capabilities.

Customizable configuration

Tailor security settings, file access permissions, and command execution rules to match your specific requirements and comfort level.

USE CASES

See how Desktop Commander serves different professionals with their specific needs

AI Software Engineer

Build products faster without coding skills.

  • Create and update big projects
  • Code review
  • Knows your codebase
  • Code security audit
  • Add test coverage
  • Improve SEO

AI DevOps

Streamline environment setup, server configuration, and deployment processes.

  • Configure local environments
  • Configure Ansible/Terraform
  • Install and configure Dockerfiles
  • Explore remote server logs
  • Configure remote servers with SSH

AI Data Analyst

Analyze CSV files, databases, and datasets instantly with Python and R.

  • Instant CSV/Excel analysis
  • Database queries with persistent connections
  • Statistical analysis with R
  • Data visualization
  • Report generation

AI Technical Writer

Maintain consistent documentation and streamline content creation processes.

  • Create and update project documentation
  • Generate release notes
  • Review and optimize content SEO
  • Keep project documentation up to date
  • Create UML and flow diagram from the code

AI UX/UI Designer

Manage design assets and streamline the implementation of designs into code.

  • Convert Figma files to product
  • Create clickable prototype faster
  • Resize and update images
  • Process design files faster, smarter, and at scale

AI Assistant

Organize files and automate document processing.

  • Organize files on your computer
  • Organize your knowledge in obsidian
  • Review and summarize documents
  • Check documents for errors

Installation

Getting started with Desktop Commander MCP is quick and easy

There are multiple options for installing DesktopCommanderMCP

Smithery Install

Install automatically via Smithery:

npx -y @smithery/cli install @wonderwhy-er/desktop-commander --client claude

NPX Install

Install using npx directly:

npx @wonderwhy-er/desktop-commander@latest setup

For macOS users, you can also use this bash script:

curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

Bash Install (macOS)

For macOS users, use our automated bash installer which will:

  • Check your Node.js version and install it if needed
  • Set up Desktop Commander automatically
  • Configure all necessary dependencies
curl -fsSL https://raw.githubusercontent.com/wonderwhy-er/DesktopCommanderMCP/refs/heads/main/install.sh | bash

This is the simplest installation method for macOS users.

Manual Configuration

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "desktop-commander": {
      "command": "npx",
      "args": [
        "-y",
        "@wonderwhy-er/desktop-commander"
      ]
    }
  }
}

Local Installation

Clone and build locally:

git clone https://github.com/wonderwhy-er/DesktopCommanderMCP
cd DesktopCommanderMCP
npm run setup

To install DesktopCommanderMCP you need to have Node.js v18.18.0+ and Claude Desktop installed on your system:

Download Node.js: https://nodejs.org/en/download

Download Claude Desktop: https://claude.ai/download


Remember to restart Claude after installation.

Trusted by Developers

Join thousands of developers who have transformed their Claude experience with Desktop Commander.

26K+

Weekly Downloads

9/10

User Rating

1800+

GitHub Stars

User Testimonials

See what developers are saying about Desktop Commander MCP

Desktop Commander MCP User Testimonials Desktop Commander MCP User Testimonials

Join Our Community

Connect with other users and contributors to share ideas, get help, and contribute to the project.

Media & Coverage

Learn more about Desktop Commander MCP from articles, videos and community

Frequently Asked Questions

Find answers to common questions about Desktop Commander MCP

Claude Desktop Commander is an MCP (Model Context Protocol) tool that allows Claude Desktop to access and control your computer's file system and terminal. It enables Claude to explore, read, and write files, execute commands, and manage processes - expanding Claude's capabilities beyond just conversation to become a comprehensive assistant that can work with your entire operating system.

How does it differ from coding tools like Cursor or Windsurf?

Unlike tools like Cursor or Windsurf which are primarily designed as coding IDEs, Claude Desktop Commander works with Claude to provide a more flexible, solution-centric approach. Key differences include:

  • Claude reads full files during exploration, ensuring it captures the complete structure
  • Coding tools like Windsurf & Cursor chunk and index files, sometimes missing key relationships
  • Claude generates and displays diagrams directly in chat
  • Claude Desktop Commander allows you to work across your entire system, not just within coding environments
How much does it cost to use Claude Desktop Commander?

Claude Commander is free and open source for personal use. For companies with annual revenue more than 1M USD and more than 10 people, we are charging $20 per license. To use DesktopCommander, you also need a Claude Pro, which costs $20 or / Claude Max subscription for $100 per month.

Is usage really "unlimited"?

Desktop Commander uses Claude Desktop's subscription model, which has usage limits that reset 2-3 times per day based on your plan tier. It's "unlimited" in that you don't pay per token like with API access, but you do have message limits. For most development work, Claude Pro's 45 messages per 5-hour window is quite generous - equivalent to 1,800+ messages per month.

Why is the fileWriteLineLimit set to 50 by default? What is the maximum value?

AIs are wasteful with tokens: Instead of doing two small edits in a file, AIs may decide to rewrite the whole thing. We're trying to force AIs to do things in smaller changes as it saves time and tokens.

Claude UX message limits: There are limits within one message and hitting "Continue" does not really work. We're trying to make AI work in smaller chunks so when you hit that limit, multiple chunks have succeeded and that work is not lost - it just needs to restart from the last chunk.

Maximum value: You can set it to thousands if you want - there's no technical restriction.

Which operating systems does it support?

Claude Desktop Commander works with Windows, macOS, and Linux. Work is ongoing to improve Windows support, WSL integration, and enhance compatibility with various Linux distributions.

Can I use Desktop Commander in any MCP client outside of Claude?

Yes, you can install Desktop Commander on other MCP clients like Cursor, Windsurf, DeepChat, or any client with MCP support. You can use any model available for that client.

Important caveats: Desktop Commander may work unexpectedly on other clients due to differences in system prompts and conflicts with their built-in tools. It's primarily designed and tested with Claude Desktop.

If you try other clients, test carefully with non-critical projects first and consider sharing your experience to help improve compatibility.

Is it safe to give Claude access to my file system?

Claude Desktop Commander operates within a configurable security framework:

  • File access can be restricted to specific directories you designate
  • Command blocking allows you to prevent execution of sensitive commands
  • Claude only performs actions your user account has permission to execute
  • No data is sent to external servers beyond what you share in Claude conversations

You can customize security settings by asking Claude about configuration options. Always review actions Claude proposes before approval, especially when working with important files or system configurations.

Is it suitable for large codebases?

Yes, users have reported success with very large codebases (one user mentioned 44k files with 11 million code lines). The tool can work across multiple projects and services simultaneously, making it suitable for complex development environments.

Does Desktop Commander automatically update?

Yes, when installed through npx or Smithery, Desktop Commander automatically updates to the latest version when you restart Claude. No manual update process is needed.

I'm having trouble installing or using the tool. Where can I get help?

Join our Discord server for community support, check the GitHub issues for known problems, or review our comprehensive FAQ for troubleshooting tips. If you encounter a new issue, please consider opening a GitHub issue with details about your problem.

How does this compare to VSCode extensions like Cline?

Tools like Cline are great options that integrate directly with VSCode. The main differences are:

  • Claude Desktop Commander works across your entire system, not just within the editor
  • It can handle automation, terminal commands, and long-running processes
  • It has a fixed cost with Claude Pro subscription rather than potential API charges
  • It provides a more flexible approach not tied to a specific editor

Many users employ both, using the right tool for different tasks.

Need help or have questions?

Join our Discord community for real-time support, discussions, and updates.

Join our Discord Server

Skip coding.
Let AI build your product.

Install DesktopCommander now