Drive & Disk setup

One command sets up the document-filing and disk-cleanup servers. It takes a few minutes the first time — they run OCR and a small AI model on your own machine, so your documents are never uploaded.

Why this isn't a one-click plugin like the Gmail extension: filing a Drive by content means reading your documents. Housekeeping does that locally — the OCR and the classifier run on your machine — so nothing leaves it. That needs a real (small) install.

Before you start

What you need

Claude Desktop (or any MCP client) — the servers register into it.
A Google account — you'll connect Drive with one browser click, no Google Cloud setup.
Windows, macOS, or Linux. The installer brings its own Python; nothing else to install first.

Step 1 — Run the installer

One command

Download and unzip Housekeeping, then from that folder:

Windows (PowerShell):

powershell -ExecutionPolicy Bypass -File packaging\drive\install.ps1

macOS / Linux:

bash packaging/drive/install.sh

It sets up the environment, installs what's needed (the first run downloads a few hundred megabytes of OCR/AI components — one time), and registers housekeeping-drive and housekeeping-disk with Claude Desktop.

Step 2 — Connect your Drive

One browser click, no Google Cloud

Run the command the installer prints:

mcp/.venv/Scripts/python.exe mcp/authorize_drive.py   # Windows
mcp/.venv/bin/python mcp/authorize_drive.py           # macOS / Linux

A browser window opens — pick your account and allow Drive access. That's it: no OAuth client to create, no consent screen to configure. The token is stored on your machine only.

Step 3 — Restart Claude Desktop and try it

Ask, preview, approve

Ask Claude to file the scans in your “to sort” folder, or to find the biggest folders on your disk. Every change comes as a dry-run plan you approve first; documents are classified locally and their text is never sent to the AI.

Your documents stay on your machine. Classification returns only a label and a date — never the text — unless you explicitly ask to hand a document to the AI.

Step 4 — Unlock (only to apply changes)

Buy once, paste the key

Scanning, classifying and every preview are free. To let the servers actually move, rename or trash files, buy the one-time $5 key — the same key unlocks Gmail, Drive and disk. Set it as HOUSEKEEPING_LICENSE or save it to mcp/license.key. It's verified offline: no account, no phone-home.