Obsidian Connector

The obsidian connector indexes Obsidian vaults.

Quick Start

hoard add --obsidian ~/Obsidian

Or configure manually:

connectors:
  obsidian:
    enabled: true
    vault_path: ~/Obsidian

Configuration Options

connectors:
  obsidian:
    enabled: true
    vault_path: ~/Obsidian

    # Chunking settings
    chunk_max_tokens: 400
    chunk_overlap_tokens: 50

Options Reference

Option	Type	Default	Description
`enabled`	bool	`false`	Enable connector
`vault_path`	string	`~/Notes`	Path to Obsidian vault
`chunk_max_tokens`	int	`400`	Target chunk size
`chunk_overlap_tokens`	int	`50`	Overlap between chunks

What Gets Indexed

The connector indexes all .md files in the vault, excluding the .obsidian/ configuration folder.

Entity Identification

Field	Value
`source`	`obsidian`
`source_id`	`{vault_name}:{relative_path}`
`entity_type`	`note`
`title`	Filename without extension
`uri`	`file:///path/to/note.md`
`tags`	`["obsidian"]`

Vault Detection

Hoard auto-detects Obsidian vaults by looking for:

.obsidian/ folder (vault config)
Common vault locations:
- ~/Obsidian
- ~/Documents/Obsidian
- ~/Documents/Notes

Run hoard init to see detected vaults.

Exclusions

By default, the Obsidian connector excludes:

.obsidian/ folder (config, not content)
Non-markdown files

Search Examples

With Obsidian content indexed:

# Find notes about a topic
hoard search "project planning" --source obsidian

# Search for content including wikilink text
hoard search "Project Notes"

Chunking

Notes are chunked using the same whitespace-based tokenization as other connectors:

Text is split into tokens using \S+ regex
Chunks target chunk_max_tokens tokens
Adjacent chunks overlap by chunk_overlap_tokens tokens

Troubleshooting

Vault Not Detected

Ensure .obsidian/ folder exists
Check vault_path is correct
Run hoard init to see detected vaults

Missing Notes

Check file extension is .md
Check file is not in .obsidian/ folder
Run hoard doctor for diagnostics