Hugo MCP Server
Developer tools
MCP remote server that lets Cursor manage Hugo site content, config, builds, and publish through tools.
Streamable HTTP MCP remote server that wraps the Hugo Generator API. Use it from Cursor (or any MCP client) to manage schemas, page records, site config (hugo.toml), generate markdown, build, and publish — without calling the REST API by hand.
What it does
- Schemas & records — Create and inspect page types and content rows via MCP tools
- Site config — Read and patch managed Hugo settings (
get_site_config/patch_site_config) that regeneratehugo.toml - Generate / build / publish — Write content files, run Hugo, and sync
public/to R2 - Themes — Import, select, and derive schemas from theme signals
Stack highlights
| Piece | Role |
|---|---|
| MCP server | Streamable HTTP endpoint for Cursor and other clients |
| Hugo Generator API | Upstream schemas, records, build, and publish |
| Docker Compose | Runs alongside the API as the mcp service |
Try it
docker compose up -d --build mcp
# MCP: http://localhost:3100/mcp
# Health: http://localhost:3100/health
Open source on GitHub — contributions and issues welcome.