hugo-frontmatter-mcp

Languages

Python 98.2% Makefile 1.1%

Top Contributors

Project Info

Created

May 7, 2025

Last Updated

September 7, 2026

License

MIT

Default Branch

main

About This Project

Hugo Frontmatter MCP is a Model Context Protocol server for reading, updating, validating, and batch-processing YAML frontmatter in Hugo content files. It exposes 14+ tools covering everything from individual field updates to directory-wide tag management.

Features

• Field Management: Read and modify individual frontmatter fields (title, date, description, draft status)
• List Operations: Add, remove, and manage list fields like tags and images
• Batch Processing: Directory-wide operations for listing all tags, finding posts by tag, renaming tags
• Date Validation: Check date format consistency across all content files
• 14+ Tools: Comprehensive coverage of frontmatter operations

Installation

# Direct
uvx --from git+https://github.com/wdm0006/hugo-frontmatter-mcp hugo-frontmatter-mcp

# Via Smithery
npx -y @smithery/cli install @wdm0006/hugo-frontmatter-mcp --client claude

# Or add to your MCP client config
{
  "mcpServers": {
    "hugo-frontmatter": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/wdm0006/hugo-frontmatter-mcp", "hugo-frontmatter-mcp"]
    }
  }
}

Usage

All operations require absolute file or directory paths. The server exposes tools for field retrieval, metadata updates, tag and image management, and batch validation across your Hugo content directory.