Back to Browse

Desktop Steward MCP Server

Developer ToolsModerate6.9MCP RegistryRemote
Free

Server data from the Official MCP Registry

Your own computer's files from ChatGPT or Claude: folder rules, confirmations and undo.

About

Your own computer's files from ChatGPT or Claude: folder rules, confirmations and undo.

Remote endpoints: streamable-http: https://relay.desktopsteward.com/mcp

Security Report

6.9
Moderate6.9Moderate Risk

Desktop Steward is a local file-management MCP server with folder-scoped read and write rules, a confirmation step before deletes and bulk moves, and undo snapshots; no network exfiltration, shell execution, or hardcoded credentials appear in the shown code. Findings are limited to low-severity observations: the MCP server runs without any authentication (acceptable for a local stdio server), a remote-session mode referenced in the code is not visible in the audited portion, and the truncated src/tools/files.ts plus the undisclosed extras module mean parts of the code could not be fully verified. The permissions requested (file_read, file_write, process_spawn is not used) match the stated purpose. Supply chain analysis found 2 known vulnerabilities in dependencies (0 critical, 1 high severity).

8 files analyzed · 6 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

File System Read

Reads files on the server that hosts it, not on your machine.

File System Write

Writes files on the server that hosts it, not on your machine.

file_delete

Applies to the server that hosts this plugin, not to your machine.

env_vars

Applies to the server that hosts this plugin, not to your machine.

filesystem_search

Applies to the server that hosts this plugin, not to your machine.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "com-desktopsteward-desktop-steward": {
      "url": "https://relay.desktopsteward.com/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Desktop Steward

Safe hands for Claude on your computer. A free extension for Claude Desktop that lets Claude tidy, find and organize your files with plain folder rules, a confirmation window before anything risky, and undo for every change.

Website and download: https://desktopsteward.com

What it does

  • Rules in plain words. You choose which folders Claude may read and which it may change. Everything else is invisible to it.
  • Asks before anything risky. Deleting, replacing a file, or moving many files opens a confirmation window on your computer. The model cannot answer it.
  • Undo for 7 days. Old versions are kept before a change; deleted files wait in a holding area; undo brings them back.
  • Off limits, always. Passwords, keys, browser data, mail, system folders, and anything that runs on double-click. No terminal, no network, no telemetry.
  • Ready-made tasks in the chat's + menu: tidy Downloads, find duplicate photos, free disk space, tidy the Desktop, find documents by topic, rename photos by date.

Read SECURITY.md for the threat model, including what it does not protect against.

Install

Download the .mcpb for your platform from the website or the Releases page and double-click it. Claude Desktop installs it like a browser extension. Press Save; the defaults are sensible.

Tools

list_folder, read_file (text, PDF, DOCX, images), write_file, edit_file, create_folder, move_files, delete_files, search_files, file_info, disk_usage, find_duplicates, undo, history, show_rules.

Public core and the official bundle

This repository is the core of Desktop Steward: the file tools, the folder rules, the confirmation step and undo. Everything that touches your files is here and can be audited. The official bundle from desktopsteward.com is built from this core plus extras that are not in this repository: a local panel with Undo buttons, images-to-PDF, zip/unzip, opening files, remote access from the phone (Pro). The extras use the same rules, confirmations and undo as the core.

Build from source

npm install
npm test            # builds and runs the test suite

Node.js 22 or newer. The .mcpb bundles are built from the private repo and published on desktopsteward.com.

Configuration

Settings live in the Claude Desktop extension panel, or in ~/.desktop-steward/config.json:

KeyDefaultMeaning
readFoldersDesktop, Documents, Downloads, PicturesFolders Claude may read and search
writeFoldersDocuments/AI Workspace, DownloadsFolders Claude may change
askBeforeDeletetrueConfirmation window before deleting
confirmThreshold10Moving more items than this asks first
keepHistoryDays7How long undo copies and deleted files are kept

Privacy

Desktop Steward reads only the folders you opened to it and keeps copies of changed or deleted files for undo in ~/.desktop-steward on your own computer (7 days by default). The core sends nothing anywhere and has no telemetry. Full policy: Privacy · Security model: Security · Contact: hello@desktopsteward.com

License

MIT. Copyright ED&EU LTD. Desktop Steward is not affiliated with Anthropic.

Reviews

No reviews yet

Be the first to review this server!