Firefox Bookmarks Connector

The bookmarks_firefox connector indexes bookmarks from Mozilla Firefox.

Quick Start

connectors:
  bookmarks_firefox:
    enabled: true

Firefox bookmarks are auto-detected from the default profile.

Configuration Options

connectors:
  bookmarks_firefox:
    enabled: true

    # Custom places.sqlite path (optional)
    places_path: ~/.mozilla/firefox/xxxxxxxx.default-release/places.sqlite

Options Reference

Option	Type	Default	Description
`enabled`	bool	`false`	Enable connector
`places_path`	string	Auto-detected	Path to Firefox places.sqlite

Auto-Detection

Hoard looks for Firefox profiles in:

Platform	Path
macOS	`~/Library/Application Support/Firefox/Profiles/`
Linux	`~/.mozilla/firefox/`
Windows	`%APPDATA%/Mozilla/Firefox/Profiles/`

The most recently modified places.sqlite is used.

What Gets Indexed

For each bookmark:

Field	Value
`source`	`bookmarks_firefox`
`source_id`	Firefox bookmark GUID
`entity_type`	`bookmark`
`title`	Bookmark title
`uri`	Bookmark URL
`tags`	`["bookmark", "firefox"]`
`metadata`	`{"folder": "folder_name"}`

Database Access

The connector always copies places.sqlite to a temporary file before reading. This means:

Firefox can remain open during sync
Data may be slightly stale if Firefox is actively writing

Bookmark Content

Each bookmark creates a chunk containing:

{title}
{url}

Search Examples

# Find bookmarks by title
hoard search "python" --source bookmarks_firefox

# Find bookmarks containing URL
hoard search "docs.python.org"

Multiple Profiles

For specific Firefox profile:

bookmarks_firefox:
  enabled: true
  places_path: ~/.mozilla/firefox/abc123.work/places.sqlite

Sync Behavior

Reads from places.sqlite copy
Deleted bookmarks are tombstoned
Folder changes update metadata

Limitations

Title and URL only — No page content
Firefox native tags — Not currently indexed
Single profile — Configure multiple instances for multiple profiles

Troubleshooting

Profile Not Found

Check Firefox is installed
Run about:profiles in Firefox to find path
Specify places_path explicitly

Missing Bookmarks

Check bookmark exists in Firefox
Run hoard connectors status