list_tags_tool
List all unique tags in your Obsidian vault with usage statistics to maintain consistency, analyze tagging patterns, and organize hierarchical tag structures.
Instructions
List all unique tags used across the vault with usage statistics.
When to use:
Before adding tags to maintain consistency
Getting an overview of your tagging taxonomy
Finding underused or overused tags
Discovering tag variations (e.g., 'project' vs 'projects')
Understanding hierarchical tag structures in your vault
Finding all files that use a specific tag (with include_files=true)
Hierarchical tags:
Lists both parent and full hierarchical paths (e.g., both "project" and "project/web")
Shows how nested tags are organized in your vault
Helps identify opportunities for better tag organization
File paths (with include_files=true):
Returns a list of all file paths that contain each tag
Useful for bulk operations on files with specific tags
Paths are relative to vault root
When NOT to use:
Getting tags for a specific note (use get_note_info)
Searching notes by tag (use search_notes with tag: prefix)
Performance note:
For vaults with <1000 notes: Fast (1-3 seconds)
For vaults with 1000-5000 notes: Moderate (3-10 seconds)
For vaults with >5000 notes: May be slow (10+ seconds)
Uses batched concurrent requests to optimize performance
include_files=true adds minimal overhead
Returns: All unique tags with optional usage counts and file paths
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include_counts | No | Show how many times each tag is used across your vault | |
| sort_by | No | Sort tags alphabetically by 'name' or by popularity with 'count' | name |
| include_files | No | Include the list of file paths that contain each tag | |
| ctx | No |