Hudu + AI in 60 seconds
Unofficial. Community-built Claude Code Skill and MCP server for the Hudu API. Not affiliated with, endorsed by, or sponsored by Hudu Technologies, Inc..
Awaiting live verification - passes every mechanical gate (build, command-surface, claims, install). Be the first to confirm it against your tenant: report it works.
Ask in plain English which clients have the worst documentation, which vault passwords are overdue for rotation, and what SSL certs, domains, or warranties expire next - across every company at once. Hudu plus your AI agent reads a local mirror of your whole instance, so the hygiene questions the portal makes you click through company by company become one instant, reproducible answer.
New to the term? An MCP server is the same thing ChatGPT calls an app or connector, Claude on the web calls a connector, and Claude Code calls a Skill. One thing, many names →
Install in 60s → View on GitHub →
Instead of clicking through Hudu, just ask
Instead of Open each client’s asset layouts in the Hudu portal and eyeball which assets are missing required fields
just ask: “Which clients have the worst documentation completeness right now?”
Your agent runs: hudu-cli audit completeness --agent
Instead of Click into every company’s password vault to find credentials nobody has rotated in months
just ask: “Show me vault passwords that haven’t been rotated in 180 days, grouped by company”
Your agent runs: hudu-cli audit stale-passwords --older-than 180d --agent
Instead of Reconcile SSL, domain, and warranty expiry dates across tenants in a spreadsheet before they lapse
just ask: “What expires in the next 30 days across all my clients?”
Your agent runs: hudu-cli audit expirations --within 30d --agent
See it in 30 seconds
Demo data is simulated. Every command shown exists in the real CLI.
What it does
| Question your MSP keeps asking | Command your agent runs |
|---|---|
| Which clients have the worst documentation completeness? | hudu-cli audit completeness --agent |
| What’s expiring in the next 30 days across every client? | hudu-cli audit expirations --within 30d --agent |
| Which vault passwords are overdue for rotation? | hudu-cli audit stale-passwords --older-than 180d --agent |
| Which knowledge-base articles are stale and probably out of date? | hudu-cli audit stale-articles --older-than 365d --agent |
| Which assets have drifted from their layout’s current schema? | hudu-cli audit layout-drift --agent |
| Give me one worst-first hygiene scorecard across every company. | hudu-cli audit summary --agent |
| Find everything matching a keyword across all synced docs. | hudu-cli search "vpn gateway" --agent |
| Resolve this Hudu link to its asset, company, and relations. | hudu-cli resolve "https://docs.example.huducloud.com/a/dc01-abc123" --agent |
| Which PSA/RMM records don’t map to a live Hudu asset? | hudu-cli reconcile --agent |
| Scaffold a new client’s docs from our house template. | hudu-cli onboard --company 42 --template msp-standard |
Full command reference at github.com/servosity/msp-skills/blob/main/skills/hudu/guide.md.
What makes this one different
Most Hudu integrations and MCP servers proxy each question into a live API call - fine for one lookup, useless when you ask about every client at once. This skill syncs your whole Hudu instance into a local SQLite mirror, so cross-tenant hygiene questions become one offline query: instant, fully paginated, and reproducible later as a snapshot you can diff against.
The Hudu portal answers one company on one page at a time; this skill answers across every client at once and hands the result to the AI agent you already work in. It complements the web app you still use for editing and day-to-day documentation - it doesn’t replace it.
The pain this closes
- Documentation rots silently: assets get created with half their required fields blank, and nobody notices until a tech needs the missing detail mid-incident.
- Hudu has no native password-expiration tracking, so stale vault credentials pile up unseen across dozens of client vaults.
- Expiring SSL certificates, domains, and warranties hide one company at a time in the portal - you find the lapse when the client’s site goes down, not before.
Install
Works in any of these agents - pick yours:
| Agent | Quick install |
|---|---|
| Claude Desktop | Step-by-step → |
| ChatGPT (Plus/Pro+) | Step-by-step → |
| Claude Code | Step-by-step → |
| Codex CLI | Step-by-step → |
| Cursor, Windsurf, Cline, Continue, Zed, Copilot, Gemini, Hermes, OpenClaw | Which agent? → |
Quickest path for everyone else (terminal):
macOS / Linux:
bash <(curl -fsSL https://raw.githubusercontent.com/servosity/msp-skills/main/skills/hudu/install.sh)
Windows (PowerShell):
iwr -useb https://raw.githubusercontent.com/servosity/msp-skills/main/skills/hudu/install.ps1 | iex
After install, authenticate once with your Hudu credentials, then verify with hudu-cli --version.
Safety model
| Tier | Examples | Recommended agent policy |
|---|---|---|
| Read | audit completeness, audit stale-passwords, audit expirations, audit summary, search, resolve, reconcile, companies list, assets list-by-company, sync, doctor | Allow |
| Write (routine) | assets create, assets update, articles create, articles update, companies create, companies update, asset-layouts create, onboard –apply | Preview with –dry-run, then a reviewed write |
| Destructive / credential | assets delete, articles delete, companies delete, asset-passwords delete, asset-passwords get, asset-passwords list, auth set-token, auth logout | Human-in-the-loop only |
The skill reads everything over a local mirror - audits, search, resolve, and reconcile are always safe to run and cannot change anything. Writes (creating or updating assets, articles, companies, and asset layouts, plus ‘onboard –apply’) send to your live Hudu instance, so the recommended agent policy is preview-then-approve. Reading or changing password-vault entries and managing the API credential are credential-tier; deletes and archives are destructive - keep both human-in-the-loop. Full details in governance.md.
Frequently asked questions
Does this work with ChatGPT?
Yes, on paid ChatGPT plans. ChatGPT connects to remote MCP servers over HTTPS, so you expose the local Hudu MCP server via a secure bridge. Step-by-step in the install guide.
Do I need to know how to code?
No. Paste one sentence into Claude Code or Codex and your agent does the install, or run a one-line installer. You enter your credentials once.
Is my Hudu data safe?
Your data stays on your machine - the CLI, MCP server, and the local mirror are all local. The password audit never reads or stores secret values; it uses only each entry’s name, username, and last-updated date. Credentials are never bundled or transmitted by MSP Skills.
What does it cost?
Free. Apache-2.0 licensed. You pay only for whichever AI agent you already use.
Will a company-scoped Hudu API key work?
Mostly. Audits and search run over whatever you’ve synced, so they work with any key. The one limit: Hudu’s global asset-list endpoint requires a global (not company-scoped) key - with a scoped key, use ‘assets list-by-company
Status
Beta. Validated against the Hudu API surface and being validated with MSPs running it live against their own production tenants in our weekly Build Sessions.
Standards. Conforms to the open Agent Skills spec (Anthropic, Dec 2025; 40+ agents). MCP-compatible - works with any MCP-capable agent including Hermes. OpenClaw-ready (frontmatter pre-wired, awaiting OpenClaw launch).
Maintained by Servosity for the MSP community. Apache-2.0 licensed. Built with CLI Printing Press.