# Desktop Steward

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: desktopsteward
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/desktopsteward/desktop-steward
- Updated: 2026-11-06
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/desktop-steward

## What it 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`.

## Requirements
- Remote server: `https://relay.desktopsteward.com/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http desktop-steward https://relay.desktopsteward.com/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add desktop-steward --url https://relay.desktopsteward.com/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "desktop-steward": {
            "url": "https://relay.desktopsteward.com/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "desktop-steward": {
            "type": "http",
            "url": "https://relay.desktopsteward.com/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http desktop-steward https://relay.desktopsteward.com/mcp
```

## When to use it
- search permitted folders for documents by topic
- find duplicate photos
- sort files from Downloads
- restore files after deletion or moving

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

## Similar
- [Skill Steward MCP](https://affpapa.org/en/nevibecode/mcp/skill-steward-mcp.md) — MCP server · ★ 13 repo stars
- [Session Steward](https://affpapa.org/en/nevibecode/mcp/session-steward.md) — MCP server · ★ 7 repo stars
- [deploy-steward](https://affpapa.org/en/nevibecode/skills/deploy-steward.md) — skill · ★ 937 repo stars
- [agent-desktop](https://affpapa.org/en/nevibecode/skills/agent-desktop.md) — skill · 12100 installs
- [windows-desktop-e2e](https://affpapa.org/en/nevibecode/skills/windows-desktop-e2e.md) — skill · 6400 installs
- [Desktop Control](https://affpapa.org/en/nevibecode/skills/desktop-control.md) — skill · 4000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
