Skip to content

obsidian

diapason.connectors.obsidian

Obsidian / Markdown vault connector.

Reads .md, .markdown, and .txt files from a local vault directory, parses optional YAML frontmatter, and yields :class:Document objects that can be ingested by the knowledge pipeline.

ObsidianConnector

Bases: BaseConnector

Connector that reads a local Obsidian (or plain Markdown) vault.

Parameters

vault_path: Absolute path to the vault root directory. An empty string means "not yet configured" — :meth:is_connected will return False.

disconnect()

Clear vault_path and mark as disconnected.

is_connected()

Return True if vault_path is set and the directory exists.

mcp_tools()

Expose a single obsidian_search_notes tool for agent queries.

sync(*, since=None, cursor=None)

Walk the vault and yield one :class:Document per text file.

Parameters

since: If provided, skip files whose mtime is before this datetime. cursor: Not used for this filesystem connector (included for API compatibility).

sync_status()

Return sync progress from the most recent :meth:sync call.