hudu-mcp

hudu-mcp is a community Model Context Protocol server for the Hudu IT documentation REST API. It exposes the documented v1 API — companies, assets, knowledge base articles, credential records, IPAM, racks, website monitors, relations, integrations, the audit trail and the export triggers — as 89 MCP tools, and it withholds stored passwords and TOTP secrets from every response unless an operator has explicitly turned that off. It is aimed at MSPs and internal IT teams who want an assistant that can read and maintain their Hudu tenant over a local stdio connection, using an API key they scope themselves.

Before you install this, look at Hudu's own MCP server

Hudu ships a first-party MCP server built into the product. It is served from your own instance at https://<your-instance>/mcp, it authenticates with Hudu OAuth rather than a long-lived API key, and it is enabled from Admin → External Apps → Model Context Protocol. Per Hudu's documentation it covers articles (create, read, update), activity logs (read) and assets (read only), and it deliberately excludes passwords, asset writes and deletions.

For a large number of people that is the better choice, and you should not install this project reflexively.

	Hudu's MCP server	hudu-mcp (this project)
Maintained by	Hudu Technologies, Inc.	Zenix Solutions, community project
Where it runs	Inside your Hudu instance, at /mcp	A local process next to your MCP client
Transport	Remote HTTP, reachable from hosted clients	stdio only (see compatibility)
Authentication	Hudu OAuth, per user	A Hudu API key you create and scope
Enabled by	Admin → External Apps → Model Context Protocol	Installing and configuring this package
Articles	Create, read, update	Create, read, update, archive, delete
Assets	Read only	Full CRUD, plus archive and layouts
Activity log	Read	Read, and purge behind two gates
Passwords	Excluded entirely	Metadata by default; secrets and writes behind gates
Deletions	Excluded entirely	Behind HUDU_ALLOW_DESTRUCTIVE and confirm: true
IPAM, racks, websites, relations, matchers, exports	Not covered	Covered
Support	Hudu support	GitHub issues, best effort