Resources · Claude connector

Claude Desktop Commander connectorWhat Claude can do in your Desktop Commander account.

The Claude Desktop Commander connector exposes 26 tools. 13 read your machine, 10 write files, start or stop programs, and 3 are not clearly classified. Here: what Claude can touch on your computer, where the guardrails stop, and what gets logged.

Verified Trustpilot reviews · AI, automation & growth agency

Overview

Why you would give Claude your files and terminal

Claude stops being a chat window that tells you what to type and starts doing it on your machine. You describe the task, and Claude reads the files, edits them, runs a program and reads its output. That is a lot of reach, which is why this page spends as long on the guardrails as on the features.

Get through a messy folder. You inherit a project nobody documented. list_directory maps the folders, start_search finds files by name or content, and read_multiple_files lets Claude read several at once before explaining how the pieces fit.

Make a precise change. A config value is wrong in three places. edit_block applies targeted replacements in text files, or cell updates in Excel files, instead of rewriting the whole document with write_file.

Run something and watch it. start_process launches a program, interact_with_process sends it commands and read_process_output reads what comes back, so Claude can test a script and report on it.

What to know first. The publisher says outright that its safety settings are not a sandbox: directory limits and blocked commands can be bypassed, and terminal commands ignore the allowed-folder list entirely. Every tool call is logged locally with its arguments, unredacted. It runs only in Claude Desktop. And nothing happens on its own: no tool fires when a file changes. For jobs that run on a schedule or an event, look at automation tools instead, a different job; our Integrations hub covers that side.

Vocabulary

Five words before you start

The vocabulary you will meet while installing Desktop Commander in Claude.

Connector
The link you set up once between Claude and something you already have, here your own computer, so Claude can work there while answering.
Tool
One named action a connector opens to Claude. Claude picks the ones it needs by itself; the directory lists all of them by name.
Authorization
The step where you grant Claude the access it will use. You give it once, per person, and you can take it back the same way.
Approval
The confirmation Claude waits for before it goes through with something that changes your files or system, shown in the chat.
MCP
The shared standard connectors are built on: it is what lets an assistant like Claude talk to an outside tool, here one on your own machine.
Connect

Plug Desktop Commander into Claude in three steps

  1. 01

    Find Desktop Commander in Claude

    In Claude Desktop's settings, open Customize, then Connectors, and look for Desktop Commander in the list. On a Team or Enterprise workspace, an Owner or Primary Owner has to enable it before members can use it.

  2. 02

    Start the connection

    Click Connect on its row and follow the steps the extension shows. If something breaks later, Disconnect it and connect it again rather than editing files by hand.

  3. 03

    Read what you are granting

    Read the access screen before you confirm. It describes what the tool will be able to reach, and that is what sets the scope. Take it literally: here the scope is your files and your terminal.

Tools

The 26 tools, grouped by what they do

Desktop Commander gives Claude 26 tools: 13 that read your account, 10 that change something in it, and 3 no official source describes.

Thirteen read, ten change files or processes, three stay unclassified. Names stay exactly as Claude shows them, in English.

  • 13 read
  • 10 write
  • 3 not documented

What Claude reads (13)

13 tools

Thirteen tools that look at files, settings, searches and running programs without changing them.

get_config

Returns the full server configuration as JSON: blocked commands, default shell, allowed folders, line limits for reading and saving, and whether telemetry is on.

When it helps
before letting Claude loose on a project, you want to see which folders it is actually allowed to touch and which commands are blocked.

Sourcegithub.com · October 1, 2026 ↗

read_file

Opens a file from your disk, a URL, an Excel workbook or a PDF, page by page or line by line so large files stay manageable.

When it helps
a supplier sent a long PDF contract and you want Claude to pull out the payment terms without you scrolling through it.

Sourcegithub.com · October 1, 2026 ↗

read_multiple_files

Loads multiple files in one go, so Claude can compare or cross-check them instead of opening each in turn.

When it helps
three versions of a budget spreadsheet sit in the same folder and you need to know which figures differ between them before a meeting.

Sourcegithub.com · October 1, 2026 ↗

list_directory

Gives a detailed, recursive listing of files and subfolders, two levels deep unless you ask for more.

When it helps
you open an old shared drive export and want to know what is inside before deciding what to keep or hand over to a colleague.

Sourcegithub.com · October 1, 2026 ↗

get_more_search_results

Fetches the next page of results from a search already running, with an offset so nothing is skipped.

When it helps
the first batch of matches did not include the file you were after and you want Claude to keep looking through the rest of the hits.

Sourcegithub.com · October 1, 2026 ↗

list_searches

Shows every search session currently running, each one still active at the moment you ask.

When it helps
a search seems stuck after you asked for several things at once, and you want to see what is still going on.

Sourcegithub.com · October 1, 2026 ↗

get_file_info

Returns detailed metadata about a file or folder, including sheet details for Excel workbooks.

When it helps
you want to know how large a log file has grown, or how many sheets a workbook holds, before asking Claude to open it in full.

Sourcegithub.com · October 1, 2026 ↗

read_process_output

Collects what a running program has printed so far, so Claude can tell you whether it succeeded or where it failed.

When it helps
a long export is running and you want to know if it threw an error halfway through without staring at the terminal yourself.

Sourcegithub.com · October 1, 2026 ↗

list_sessions

Lists all the terminal sessions that are currently active on the machine.

When it helps
after a long afternoon of tests you want to know which sessions are still open before closing your laptop, so nothing keeps running in the background unnoticed.

Sourcegithub.com · October 1, 2026 ↗

list_processes

Shows every program running on the machine, with detailed information for each one.

When it helps
your computer suddenly slowed down and you want Claude to spot which program is eating the resources before you decide what to close, all without opening a system monitor.

Sourcegithub.com · October 1, 2026 ↗

get_usage_stats

Reports usage statistics of Desktop Commander for your own insight, nothing more.

When it helps
you are deciding whether the extension earns its place on your machine and want a sense of how often you actually lean on it during a normal week.

Sourcegithub.com · October 1, 2026 ↗

get_recent_tool_calls

Retrieves the recent history of tool calls with their arguments and outputs, meant for debugging and picking up context.

When it helps
a conversation crashed mid-task and you want Claude to see what it had already done.
Watch out
that history is stored locally and can contain sensitive arguments.

Sourcegithub.com · October 1, 2026 ↗

What Claude changes (10)

10 tools

Ten tools that write files, change settings, or start and stop programs. No source describes a confirmation specific to any of them: the general rule below applies.

set_config_value

Approval: see the rule

Changes one setting by key, such as the allowed folders, the blocked commands, the default shell, the line limits or telemetry.

What Claude asks for
no source describes a dedicated confirmation; the general approval rule applies.
When it helps
you want to restrict file access to a single projects folder.
Watch out
the publisher advises changing settings in a separate chat from your actual work.

Sourcegithub.com · October 1, 2026 ↗

write_file

Approval: see the rule

Saves content to a file, either replacing what is there or appending to it, and handles Excel files too.

What Claude asks for
no source documents a confirmation for this tool, so rely on the general rule.
When it helps
you want a meeting summary saved as a text file next to the project notes.

Sourcegithub.com · October 1, 2026 ↗

write_pdf

Approval: see the rule

Produces a new PDF from Markdown, or alters an existing one by inserting or deleting pages, with styling and graphics support.

What Claude asks for
nothing specific is documented; the default approval rule covers it.
When it helps
you need a clean one-page PDF of a proposal drafted in the chat, ready to send to a client.

Sourcegithub.com · October 1, 2026 ↗

create_directory

Approval: see the rule

Adds a new directory on your disk, or confirms one already exists so later steps can rely on it.

What Claude asks for
no dedicated confirmation is described for this tool; see the general rule.
When it helps
you are starting a new client project and want the usual folder structure set up before any file lands in it.

Sourcegithub.com · October 1, 2026 ↗

move_file

Approval: see the rule

Relocates or renames files and directories on your machine.

What Claude asks for
the sources describe no confirmation specific to this tool; the general rule applies.
When it helps
a downloads folder full of invoices needs sorting into one subfolder per month, with consistent names.

Sourcegithub.com · October 1, 2026 ↗

edit_block

Approval: see the rule

Applies targeted text replacements in a file, or updates a range of cells in an Excel file, without rewriting the rest.

What Claude asks for
no source describes a confirmation of its own; the general rule applies.
When it helps
one price changed in a long quote template and everything else must stay identical.

Sourcegithub.com · October 1, 2026 ↗

start_process

Approval: see the rule

Launches a program on your computer and detects when it is ready for input, which opens the door to running scripts, servers or shells.

What Claude asks for
no dedicated confirmation is documented; rely on the general rule.
When it helps
you want Claude to run a data-cleaning script on a CSV export.
Watch out
terminal commands are not bound by the allowed-folder list.

Sourcegithub.com · October 1, 2026 ↗

interact_with_process

Approval: see the rule

Sends commands to a program that is already running and gets its responses back, like typing into it yourself.

What Claude asks for
the sources do not describe a specific confirmation; the default rule applies.
When it helps
you opened an interactive data session and want Claude to try a few queries in it.

Sourcegithub.com · October 1, 2026 ↗

force_terminate

Approval: see the rule

Forcibly ends a running terminal session, whatever it was doing at that moment.

What Claude asks for
no confirmation specific to this tool is described; see the general approval rule.
When it helps
a script went into a loop and keeps the machine busy.

Sourcegithub.com · October 1, 2026 ↗

kill_process

Approval: see the rule

Stops a running program identified by its process number.

What Claude asks for
no source documents a dedicated confirmation; the general rule covers it.
When it helps
a frozen app refuses to close and you would rather not open a system monitor.

Sourcegithub.com · October 1, 2026 ↗

Not classified (3)

3 tools

One has no description in any source; two are described by the publisher without a clear read or write effect on your data.

give_feedback_to_desktop_commander

Described by the publisher as opening a feedback form in your browser addressed to the Desktop Commander team. No source says whether anything from your machine is passed along, so it stays unclassified here. The general approval rule described further down applies to it.

get_prompts

No source describes this tool at all. The directory sheet only gives its name, with no description next to it, so this page cannot say whether it reads or changes anything on your machine. Whatever it turns out to do, the general approval rule below covers it.

Approvals

What Claude asks you before it acts

By default, Claude stops and asks for your go-ahead before each action it takes for you. On a tool that can write files and run programs, that default is your main line of defense.

On Team and Enterprise, workspace owners decide whether a member can let some actions through without being asked again. They can also cap what a connector may do for the whole organization, keeping reads open and closing writes, and nobody bypasses that from their own account. Claude works with the rights of your user account on the machine and nothing more. The official per-tool label (read-only versus write and delete) only appears in a connected account's settings.

Plans

Which plans it works on

Of the 819 sheets in the official directory, 0 shows plan availability. The connector-by-connector answer is not published anywhere: it is a real gap in the catalog.

The general rule is published. Remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, while desktop extensions like this one install in Claude Desktop. On Team and Enterprise, an Owner or Primary Owner opens the connector for the organization before members can connect. For the current state, check this connector's sheet in the official directory.

Limits

Where this connector stops

A connector is not an automation. Claude calls these tools while it answers you: nothing starts when a file lands in a folder or a process crashes.

Only the publisher documents this connector; no Claude help page covers it. The partner badge in the directory is not a security audit, and Anthropic says on every sheet that it does not choose the tools a publisher exposes or vouch for how they behave. That matters more here than almost anywhere, since this extension reaches your terminal. For stronger isolation, the publisher points to its Docker installation. Every directory connector has its own page with us, for example the Claude affinity connector.

Need help

Need help connecting Desktop Commander to Claude?

A person reads every message.

FAQ

Claude Desktop Commander connector: common questions

01What can Claude do with the Desktop Commander connector?
Claude can work directly on your own computer from a conversation. Its tools read files, PDFs and Excel workbooks, list and search folders, write and edit files, produce PDFs, create, move and rename folders and files, start programs, send them commands, read their output and stop them. It can also show and change the extension's own settings, and report usage statistics and recent tool calls. All of it runs locally, inside Claude Desktop, with your user account's rights.
02Can Claude write, move or delete things on my computer?
Yes. Ten of the documented tools change something: writing and editing files, producing or altering PDFs, creating folders, moving or renaming files, changing settings, and starting, steering or stopping programs. Through the terminal, Claude can in practice run any command your account can run. That is why the publisher insists its guardrails are not a sandbox and recommends its Docker installation for stronger isolation. Keep that in mind before granting it to a machine holding sensitive data.
03Does Claude ask before it changes files or runs commands?
No source describes a confirmation specific to a Desktop Commander tool, so the general rule applies: by default Claude asks before each action it takes for you. On Team and Enterprise, owners decide whether members can let some actions through without being asked, and they can block writing tools for the whole organization. The publisher adds a practical warning: change the extension's settings in a separate chat from your work.
04Which Claude plans is it available on?
No official source publishes plan availability connector by connector, and none of the 819 directory sheets displays it. The general rule says remote connectors are open to all users on Claude, Cowork, Claude Desktop and mobile, and that desktop extensions like this one install in Claude Desktop. On Team and Enterprise, an Owner or Primary Owner enables a connector first. The connector's sheet in the directory shows its current state.
05Does Claude see my whole computer with Desktop Commander?
It can reach whatever your user account can reach, so in practice far more than one folder. The allowed-folder setting limits file operations, but the publisher warns that terminal commands ignore it, and that symlinks, absolute paths or code execution can get around the restrictions. An empty folder list opens file access to the entire filesystem. Treat the extension as access to your computer, not to a single project, and set it up accordingly.
06What does Desktop Commander keep about my sessions?
More than you might expect, all of it on your own machine. Each tool call is appended to a local log with a timestamp, the tool name and its arguments, which are not redacted and can include command text or file paths. A separate local history also stores results for the recent tool calls feature. Optional telemetry is pseudonymous and excludes file contents, paths and arguments, and you can switch it off.
07Claude or an automation tool for local tasks?
They answer different needs, so it depends on the task. Claude with Desktop Commander works inside a conversation: you ask, it reads, edits or runs things on your machine, and nothing else happens once you stop typing. It does not start on its own when a file appears or at a set time. For jobs that run in the background on a schedule or an event, an automation tool is built for that. For hands-on work you supervise, the connector fits.