Google Drive Search

Local full-text search across your Google Drive, built for the Vellum assistant.

Indexes file names, paths, and document content into a SQLite FTS5 database so the assistant can find files, snippets, and Drive links in milliseconds — without calling the Google Drive API for every lookup.

How it works

Google Drive folder
  ↓ crawl metadata + export supported docs
Indexing engine
  ↓ extract text, chunk, preserve metadata
SQLite FTS5 database (local)
  ↓ full-text search
Assistant tool results
  → file names, paths, snippets, Drive links

All indexing stays on your machine. Document text never leaves your computer.

Setup

1. Install the plugin

assistant plugins install google-drive-search

2. Connect Google

The plugin uses your assistant's managed Google connection — no API keys or tokens to handle. If Google isn't connected yet:

assistant oauth connect google

Approve the consent screen (Drive scope is included in the managed connection).

3. Index your Drive

Ask the assistant:

"Index my Google Drive"

It runs drive_index, which crawls your Drive and builds the local search index. Large Drives can take a few minutes; the crawl keeps running even if the tool call times out — check progress with drive_status.

Tools

Tool	Purpose
drive_search	Search indexed Drive files by keyword. Returns names, paths, snippets, and Drive links.
drive_status	Check index status: file count, size, last build metrics, connection status.
drive_index	Build or update the index. Supports full rebuild and incremental updates.

Configuration

A config.json is created in the plugin storage directory on first run:

{
  "rootFolderId": "root",
  "maxDepth": -1,
  "indexContentTypes": [
    "application/vnd.google-apps.document",
    "application/vnd.google-apps.spreadsheet",
    "application/vnd.google-apps.presentation",
    "text/plain",
    "text/markdown"
  ],
  "maxContentBytes": 10485760
}

• rootFolderId: Drive folder ID to crawl. "root" = entire My Drive. Use a specific folder ID to index a subtree.
• maxDepth: Folder traversal depth. = unlimited, = only top-level files.