hugo-frontmatter-mcp

MCP server for managing Hugo frontmatter.

Install

Install and configure the MCP from https://mcginniscommawill.com/oss/hugo-frontmatter-mcp/ now. Follow the documentation's installation instructions, ask me for anything you can't complete yourself, and verify its tools load.

View documentation

README

Languages

Python 98.3%

Project Info

Created

May 7, 2025

Last Updated

October 4, 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.