Using Connectors

Connectors are plugins that import data from various sources into Hoard. This guide covers how to configure and use them.

Available Connectors

Connector	Type	Description
`local_files`	Core	Local filesystem files
`inbox`	Core	Agent inbox drop folder
`obsidian`	Core	Obsidian vault (markdown files)
`bookmarks_chrome`	Core	Chrome browser bookmarks
`bookmarks_firefox`	Core	Firefox browser bookmarks
`notion_export`	Community	Notion workspace export

Quick Add

Add sources without editing config files:

# Add a folder
hoard add ~/Documents/Notes

# Add inbox folder
hoard add --inbox ~/.hoard/inbox

# Add Obsidian vault
hoard add --obsidian ~/Obsidian

# Add Notion export
hoard add --notion ~/Downloads/notion-export.zip

Configuration

Connectors are configured in ~/.hoard/config.yaml:

connectors:
  local_files:
    enabled: true
    paths:
      - ~/Documents/Notes
      - ~/Documents/Projects
    include_extensions:
      - .md
      - .txt
      - .csv

  inbox:
    enabled: true
    path: ~/.hoard/inbox

  obsidian:
    enabled: true
    vault_path: ~/Obsidian

  bookmarks_chrome:
    enabled: true

  bookmarks_firefox:
    enabled: true

  notion_export:
    enabled: true
    export_path: ~/Downloads/notion-export.zip

Local Files Connector

The most common connector for indexing local documents.

Options

Option	Type	Description
`paths`	list	Folders to scan
`include_extensions`	list	File types to include
`chunk_max_tokens`	int	Maximum chunk size (default: 400)
`chunk_overlap_tokens`	int	Overlap between chunks (default: 50)

Example

local_files:
  enabled: true
  paths:
    - ~/Documents/Notes
    - ~/Documents/Work
  include_extensions:
    - .md
    - .txt
    - .csv
    - .json

Inbox Connector

The inbox connector indexes a single drop folder used by agents and humans.

Options

Option	Type	Description
`path`	string	Inbox folder path
`include_extensions`	list	File types to include
`chunk_max_tokens`	int	Maximum chunk size (default: 400)
`chunk_overlap_tokens`	int	Overlap between chunks (default: 50)

Example

inbox:
  enabled: true
  path: ~/.hoard/inbox

Obsidian Connector

Indexes Obsidian vaults (markdown files, excluding .obsidian/ folder).

Options

Option	Type	Description
`vault_path`	string	Path to Obsidian vault
`chunk_max_tokens`	int	Maximum chunk size (default: 400)
`chunk_overlap_tokens`	int	Overlap between chunks (default: 50)

Example

obsidian:
  enabled: true
  vault_path: ~/Obsidian

Note: Files are treated as plain text markdown. No special handling for wikilinks or frontmatter.

Browser Bookmarks

Chrome

bookmarks_chrome:
  enabled: true

Chrome bookmarks are automatically detected from the default profile location.

Firefox

bookmarks_firefox:
  enabled: true

Firefox bookmarks are read from places.sqlite.

The connector automatically copies places.sqlite to a temp file, so Firefox can remain open during sync.

Notion Export

For importing Notion workspace exports:

notion_export:
  enabled: true
  export_path: ~/Downloads/notion-export.zip

Supports HTML, Markdown, and CSV export formats.

Sync Status

Check connector status:

hoard connectors status

Output:

Connector         Enabled   Entities   Last Sync
local_files       yes       1,200      2026-02-03T10:15:00
obsidian          yes       1,256      2026-02-03T10:15:00
notion_export     yes       98         2026-02-03T10:15:00

Manual Sync

Trigger a sync for all connectors:

hoard sync

Output:

Syncing local_files...
  Entities: 251, Chunks: 820, Tombstoned: 0, Errors: 0
Syncing obsidian...
  Entities: 356, Chunks: 1325, Tombstoned: 2, Errors: 0

Community Connectors

Additional connectors can be added by implementing the ConnectorV1 interface. See the Connector SDK for details.

Note: In v1, connectors are trusted code. Review any community connectors before installing.

Next Steps

Local Files Connector — Detailed configuration
Agent Inbox Connector — Drop-folder ingestion
Obsidian Connector — Obsidian-specific features
Connector SDK — Build your own connector