# Duplicacy MCP

> Duplicacy MCP is an open-source MCP server for cloud and infrastructure. Read-only MCP server that reports Duplicacy backup health from a Prometheus exporter. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Repository:** https://github.com/geiserx/duplicacy-mcp
- **MCP Registry name:** io.github.GeiserX/duplicacy-mcp
- **Categories:** cloud and infrastructure
- **Listing updated:** 2026-11-15

## About

Rather than reading backup storage itself, this bridge reads the metrics of duplicacy-exporter and exposes them to an assistant. The headline call, get_backup_overview, gives every backup a verdict of ok, running, stale, never or failed with a reason and the age of the last success; max_age_hours (default 26) decides when a backup counts as stale.

Other tools list snapshot IDs and targets, show one snapshot's state, report the last completed run, show whether a prune is running, and summarise storage size and revisions. Everything is read-only and tools carry readOnlyHint. It also offers three resources: duplicacy://status, progress and health.

HTTP mode listens on 127.0.0.1:8080 by default; any other address needs a bearer token. The Docker image refuses to start without MCP_AUTH_TOKEN. Licensed GPL-3.0-or-later.

## Features

- **Backup verdicts:** One call labels each backup ok, running, stale, never or failed.
- **Snapshot status:** Per-snapshot state across storage targets and machines.
- **Prune status:** Shows whether a prune is running and when one last succeeded.
- **Storage usage:** Reports size, chunks and revisions per snapshot.
- **Read-only by design:** Tools only read the exporter.
- **Stdio and HTTP:** Runs through npm over stdio or as a Docker image over HTTP.
- **Token-protected HTTP:** Non-loopback addresses require a bearer token.

## Good for

- Ask whether last night's backups succeeded
- Spot snapshots that have gone stale
- Check whether a prune is still running
- Watch storage growth per snapshot

## Install

### Claude Code (Terminal)

```sh
claude mcp add duplicacy-mcp -- npx -y duplicacy-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "duplicacy-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "duplicacy-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "duplicacy-mcp"
      ]
    }
  }
}
```

## Tools

- `get_backup_overview`: Health verdict for every backup with reason and age of last success.
- `list_snapshots`: Snapshot IDs, storage targets and machines.
- `get_backup_status`: State and last-run details of one snapshot.
- `get_backup_history`: Last completed run of one snapshot.
- `get_prune_status`: Whether a prune is running and when the last one succeeded.
- `get_storage_usage`: Storage size, chunks and revisions per snapshot.

## FAQ

### What does it need?

A running duplicacy-exporter; set DUPLICACY_EXPORTER_URL to its address.

### Can it change my backups?

No. Every tool and resource only reads the exporter.

### How are staleness thresholds set?

get_backup_overview takes max_age_hours, defaulting to 26.

### What licence is it under?

GPL-3.0-or-later.

### How much history is available?

The exporter keeps only the last run, so get_backup_history returns the last completed run of one snapshot.

### Is Duplicacy MCP free?

Yes. Duplicacy MCP is open source, so you can use and self-host it for free.

### How do I add Duplicacy MCP to Claude Code?

Run this command in your terminal: claude mcp add duplicacy-mcp -- npx -y duplicacy-mcp

### What are the best alternatives to Duplicacy MCP?

The closest alternatives to Duplicacy MCP are Agent Yurt, Proofline, filex, MagicWP MCP and Kubana Cloud Domains.

## Alternatives

- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [filex](https://ai-powered.com/mcp/filex): filex is an open-source MCP server for files and documents.
- [MagicWP MCP](https://ai-powered.com/mcp/magicwp-mcp): MagicWP MCP is an MCP server for cloud and infrastructure.
- [Kubana Cloud Domains](https://ai-powered.com/mcp/kubana-cloud-domains): Kubana Cloud Domains is a paid MCP server for cloud and infrastructure.
- [Kubana Cloud DNS Management](https://ai-powered.com/mcp/kubana-cloud-dns-management): Kubana Cloud DNS Management is a free MCP server for cloud and infrastructure.
- [Kubana Cloud VPS](https://ai-powered.com/mcp/kubana-cloud-vps): Kubana Cloud VPS is a paid MCP server for cloud and infrastructure.
- [AgentViva](https://ai-powered.com/mcp/agentviva): AgentViva is a free MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/duplicacy-mcp
