not-first/autorestic-mcp

Autorestic MCP Server

An MCP (Model Context Protocol) server for managing and querying autorestic backup repositories. This server allows AI language models to easily access information about restic repositories through autorestic's command interface.

Available Tools

This MCP server exposes the following tools for interacting with Autorestic repositories:

• list-backends: Lists the configured backend names from your Autorestic configuration. Call this first to discover valid backend identifiers.
• get-repository-stats: Retrieves overall repository statistics for a given backend.
• get-repository-config: Returns the full configuration details for a specific backend, including paths, types, and custom settings defined in .autorestic.yml.
• list-snapshots: Lists all snapshots for a backend, returning snapshot IDs, creation timestamps, and metadata.
• get-latest-snapshot: Fetches metadata for the most recent snapshot, including its ID and timestamp.

Usage

To install the package globally, run:

npm install -g autorestic-mcp
autorestic-mcp /path/to/.autorestic.yml

Alternatively, you can use it without global installation via npx:

npx autorestic-mcp /path/to/.autorestic.yml

Example Configuration

You can integrate the MCP server into any supported services by using their configuration. For VSCode, use:

{
	"servers": {
		"autorestic": {
			"command": "npx",
			"args": [
				"autorestic-mcp",
				"/path/to/.autorestic.yml"
			],
			"type": "stdio"
		}
	}
}

Replace /path/to/.autorestic.yml with the path to your Autorestic configuration file.