Skip to main content
MCP server CX Codex

Desktop Steward — Claude Code MCP server: setup and file access

The Desktop Steward MCP server for Claude Code lets an agent work with files in folders governed by plain-language rules. It asks for approval before risky actions and keeps changes reversible for 7 days by default.

MIT ★ 1 updated 2026-11-06

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http desktop-steward https://relay.desktopsteward.com/mcp
Open on GitHub

What Desktop Steward does

Desktop Steward provides tools to search, read, and change files in folders granted by the user. It can locate documents by topic, detect duplicate photos, sort files, and inspect disk usage. Reading covers text, PDF, DOCX, and image files.

Folder rules separate read access from write access. Deleting or replacing files triggers a confirmation window; moving more items than the configured threshold does too. Copies of changed and deleted files stay on the computer for undo, for 7 days by default. The core has no telemetry and does not send data elsewhere; it also has no terminal access.

Claude Code connects through an HTTP MCP relay using the command below. Other listed installation options include Codex, Cursor, GitHub Copilot, and Gemini CLI. Folder settings can also be edited in ~/.desktop-steward/config.json.

What it helps with

  • search permitted folders for documents by topic
  • find duplicate photos
  • sort files from Downloads
  • restore files after deletion or moving

Example prompts for the agent

  • Find documents about the budget in my permitted folders.
  • Locate duplicate photos.
  • Sort the files in Downloads into folders and ask before moving them.

How to install Desktop Steward

Platform CLI: remote server

claude mcp add --transport http desktop-steward https://relay.desktopsteward.com/mcp

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about Desktop Steward

How do I install Desktop Steward in Claude Code?

Run claude mcp add --transport http desktop-steward https://relay.desktopsteward.com/mcp to add the server over HTTP.

What does Desktop Steward do?

It gives an agent tools to search, read, and modify files in permitted folders. Risky actions require approval, and changed or deleted files can be restored for 7 days by default.

How does Desktop Steward control file access?

Rules define separate folders for reading and writing. Settings are available in Claude Desktop or in ~/.desktop-steward/config.json.

Similar MCP servers

MCP servers catalog →

Project sponsors

Companies that keep this analytics open