$ Install Undisk MCP

Everything you need to connect AI agents to versioned, reversible file workspaces. SDKs for every major language. Clear setup for Claude Desktop, Claude CLI, Codex, and Gemini.

⟲ Quick Start

Pick the command that matches your client. Claude Desktop uses a local setup script, while Claude CLI can connect directly over HTTP.

Replace sk_live_… with your API key. Get one →

Using both Claude Desktop and Claude CLI is fine. Add Undisk separately in each client so both can connect to the same workspace with the same key.

Claude Desktop

npx @undisk-mcp/setup-claude

Writes the Undisk entry into claude_desktop_config.json and runs the local stdio bridge for Claude Desktop.

Claude CLI

claude mcp add --transport http undisk https://mcp.undisk.app/v1/mcp --header 'Authorization: Bearer sk_live_…'

Use this in Claude CLI or Claude Code when you want a direct HTTP MCP connection instead of a Desktop local dev entry.

OpenAI Codex

codex mcp add undisk --env UNDISK_API_KEY=sk_live_… -- npx -y @undisk-mcp/stdio-proxy

Gemini CLI

gemini mcp add --transport http --scope user -H 'Authorization: Bearer sk_live_…' undisk https://mcp.undisk.app/v1/mcp

If tools don't appear, run /permissions inside Gemini to trust the current folder.

⟩ Client Tools

CLI, local proxy, and one-command setup for your MCP client

@undisk-mcp/setup-claude npm

One-command Claude Desktop setup — writes the local Undisk MCP entry to claude_desktop_config.json

npx @undisk-mcp/setup-claude
@undisk-mcp/local-proxy npm

Local stdio-to-HTTP proxy for MCP clients that only support local servers

npm install -g @undisk-mcp/local-proxy
@undisk-mcp/cli npm

Command-line interface for workspace management, file operations, and debugging

npx @undisk-mcp/cli

⟨⟩ SDKs

Language-specific clients for TypeScript, Python, Rust, and Go

@undisk-mcp/sdk npm

TypeScript SDK — workspace client, file operations, version management

npm install @undisk-mcp/sdk
@undisk-mcp/types npm

TypeScript type definitions for Undisk MCP API requests, responses, and events

npm install @undisk-mcp/types
@undisk-mcp/mcp-schema npm

MCP tool schemas and tools.json — machine-readable tool definitions

npm install @undisk-mcp/mcp-schema
undisk-mcp PyPI

Python SDK for Undisk MCP — async workspace client with type hints

pip install undisk-mcp
undisk-mcp crates.io

Rust SDK for Undisk MCP — async client with serde serialization

cargo add undisk-mcp
undisk-mcp-go Go

Go SDK for Undisk MCP — workspace client with context support

go get github.com/kiarashplusplus/undisk-mcp-go

⇄ Integrations

Plug Undisk into CI/CD pipelines and automation platforms

@undisk-mcp/github-action npm

GitHub Action for CI/CD — workspace snapshots, policy checks, audit exports

uses: kiarashplusplus/undisk-mcp-action@v1
n8n-nodes-undisk npm

n8n community node — use Undisk MCP in n8n automation workflows

npm install n8n-nodes-undisk
@undisk-mcp/webhook-client npm

Webhook receiver — verify signatures, parse events, handle retries

npm install @undisk-mcp/webhook-client
@undisk-mcp/audit-verifier npm

Audit trail verifier — validate hash-chain integrity for compliance evidence

npm install @undisk-mcp/audit-verifier
@undisk-mcp/policy npm

Policy engine — evaluate path ACLs, extension rules, size limits, and secret scanning

npm install @undisk-mcp/policy

▶ Platforms

Run Undisk MCP via Docker or npx without a permanent install

Docker Platform

Run Undisk MCP via Docker MCP Hub — containerized deployment

docker run ghcr.io/kiarashplusplus/undisk-mcp
npx CLI Platform

Run the CLI without installing — instant access to all workspace commands

npx @undisk-mcp/cli

Every agent write versioned. Any file restored in <50ms.

Pick your language, connect your MCP client, and ship with undo built in.

Get Started Free