• MISSING
  • DUPLICATE
  • INCONSISTENT
  • HUMAN

How to audit markdown note tags with your AI

Connect your vault once. From there, your AI handles the heavy lifting of scanning every file for tag inconsistencies.

Ask AI about this page

Short answer

How can I audit my markdown note tags using AI?

Your AI uses the harvested frontmatter to scan your entire vault for tag errors. It identifies where you've used the same tag differently or where tags are missing entirely. You'll get a clear list of every inconsistency to fix.

Audit results

Where every issue lands.

The AI organizes its findings into specific categories for you to review.

MISSING

Missing tag alerts

The AI finds notes that lack required metadata fields. You get a list of files that need new tags added.

DUPLICATE

Redundant tag detection

It catches instances where you've used the same tag twice in one file. This helps keep your metadata clean.

INCONSISTENT

Tagging style mismatches

The AI flags where you've used variations of the same tag, like 'work' versus 'Work'. You'll see exactly which ones to unify.

HUMAN

Manual cleanup list

The AI provides a summary of files that require your direct attention. You decide which tags to merge or delete.

The workflow

What your AI does when the data arrives.

The AI moves from raw data extraction to actionable intelligence.

  1. Extract metadata

    The AI pulls the YAML frontmatter from every markdown file in your vault. This creates the dataset needed for the audit.

    harvest_markdown_frontmatter

  2. Identify patterns

    It compares the extracted tags against your established naming conventions. It looks for typos and casing errors.

    harvest_markdown_frontmatter

  3. Flag discrepancies

    The AI isolates files where tags are missing or where duplicates exist. It builds a map of these errors.

    harvest_markdown_frontmatter

  4. Generate report

    It presents a structured list of every file that needs a fix. You receive a clear set of instructions for your cleanup.

    harvest_markdown_frontmatter

Try it

Copy these to start.

Use these prompts once you've connected the MCP.

Starting points

Swap the bracketed text for your specific folder names or tag preferences.

Markdown Frontmatter Harvester Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — Markdown Frontmatter Harvester capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "markdown-frontmatter-harvester-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_pSzsBgFkLuKZKUA1Ej60Dr18di9s0JV9d52i5cdI/mcp"
    }
  }
}
Copy into chat04

  • Scan my vault and list all notes that are missing a 'status' tag.

  • Find all duplicate tags in my 'Projects' folder.

  • Identify any inconsistent casing in my tags, like 'research' vs 'Research'.

  • Give me a list of files in my 'Daily Notes' folder that have no tags at all.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect Markdown Frontmatter Harvester once, then ask.

Click the link to connect to your preferred client. Your credentials stay encrypted, and you can start auditing immediately.

Connect Markdown Frontmatter Harvester to your AI

FAQ

how this task behaves.

  • 01

    Can the AI change my tags for me?

    No. The AI only reads and analyzes the frontmatter. You must manually edit your files to apply any changes.

  • 02

    Does it delete any of my notes?

    No. This MCP is read-only. It cannot delete, move, or modify your files in any way.

  • 03

    How does it know which tags are 'correct'?

    You tell the AI what your preferred tagging style is in your prompt. It then compares your files against those rules.

  • 04

    Can it scan my entire Obsidian vault?

    Yes, as long as your AI client has access to the local folder where your vault is stored.

  • 05

    Will it work with any markdown editor?

    It works with any MCP-compatible client, such as Claude, Cursor, or VS Code, regardless of which editor you use to view the files.

  • More questions about Markdown Frontmatter Harvester? The Connector page answers them. See everything the Markdown Frontmatter Harvester Connector can do

Connect Markdown Frontmatter Harvester to Claude, Cursor, ChatGPT & more