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
claude mcp add --transport http desktop-steward https://relay.desktopsteward.com/mcpWhat 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/mcpPlatform CLI: remote server
codex mcp add desktop-steward --url https://relay.desktopsteward.com/mcpConfig file
{
"mcpServers": {
"desktop-steward": {
"url": "https://relay.desktopsteward.com/mcp"
}
}
}Config file
{
"servers": {
"desktop-steward": {
"type": "http",
"url": "https://relay.desktopsteward.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http desktop-steward https://relay.desktopsteward.com/mcpStep 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.