Markdown Frontmatter Harvester

Markdown Frontmatter Harvester MCP Connector for Claude

A+

Scan local Obsidian or Hugo vaults and extract all YAML frontmatter (tags, dates, status) into a single structured JSON. Let your AI query your scattered notes metadata instantly.

1 tools Official Updated Jun 28, 2026 Official Vinkius Partner

If you use a Knowledge Management system like Obsidian, Logseq, or Hugo, you likely use YAML 'frontmatter' at the top of your markdown files to track metadata like status: draft, tags: [idea, research], or date: 2024-01-01.

When you ask Claude, 'Which of my notes are marked as drafts and never published?', it fails because it can't read thousands of local files quickly. This MCP solves that by acting as a hyper-fast metadata librarian. It recursively scans your local folder, rips out only the YAML frontmatter from every file, and aggregates it into a clean JSON index. The AI can then instantly filter, sort, and query your entire knowledge base.

The Superpowers

  • Vault-Wide Indexing: Turns scattered local markdown metadata into a unified database.
  • Lightning Fast: Uses fast-glob and gray-matter to scan 1,000+ files in milliseconds.
  • Zero Config: Just give the AI the absolute path to your notes folder.
  • 100% Air-Gapped Privacy: Your private journal entries and business notes never leave your machine.
yaml-parsingmetadata-extractionmarkdownobsidianvault-managementstructured-data

1 tools expose this connector's capabilities to your AI agent.

harvest_markdown_frontmatter

Provide the absolute directory path. Scan a local directory of Markdown files (Obsidian/Hugo) and extract all YAML frontmatter tags, dates, and metadata

See how to talk to your AI agent using Markdown Frontmatter Harvester.

Scan my Obsidian vault at C:/Notes and list all files that have the tag 'urgent'.

I found 5 notes with the tag 'urgent'. Here are their filenames: ProjectX.md, MeetingNotes.md...

Harvest the frontmatter from my blog repo and tell me which posts are still marked as 'status: draft'.

Based on the frontmatter, you have 12 posts still marked as 'draft'. Would you like the list?

Count how many notes I created in the year 2023 based on the YAML 'date' field.

According to the metadata, you created exactly 142 notes in 2023.

No. To protect your privacy and save context tokens, it strictly extracts ONLY the YAML metadata block between the `---` delimiters. The actual body text of your note is ignored.

Related Connectors