Google Drive Folder Link

An Obsidian plugin that lets you attach a Google Drive folder to a note via fuzzy search. Search across configured root folders in My Drive and Shared Drives, and access linked folders with one click from the note's properties pane.

Features

• Fuzzy search across Google Drive folders within configured root folders
• Supports both My Drive and Shared Drives
• Folder association stored in note frontmatter
• Clickable link in the Properties pane to open the folder in your browser
• Command palette and context menu integration

Setup

1. Create Google Cloud OAuth Credentials

This plugin requires each user to create their own Google Cloud OAuth credentials.

1. Go to the Google Cloud Console
2. Create a new project (or select an existing one)
3. Enable the Google Drive API:
   • Navigate to APIs & Services > Library
   • Search for "Google Drive API" and click Enable
4. Configure the OAuth consent screen (you must do this before creating credentials):
   • Navigate to APIs & Services > OAuth consent screen
   • If you are using a Google Workspace account: Select Internal as the app type. This makes the app available to users within your organization without further review.
   • If you are using a personal Gmail account: Select External as the app type. The app will be created in "Testing" mode. You must add your own Gmail address as a test user under OAuth consent screen > Test users so that you can authorize the app. This avoids needing to go through Google's verification process.
   • Fill in the required fields (App name, User support email, Developer contact email). The values are only for your own reference.
   • On the Data access (or Scopes) screen, click Add or Remove Scopes, search for Google Drive API, and select .../auth/drive.readonly ("See and download all your Google Drive files"). Click Update to confirm, then save.
   • Complete the remaining steps and save.
5. Create OAuth 2.0 credentials:
   • Navigate to APIs & Services > Credentials
   • Click Create Credentials > OAuth client ID
   • Application type: Desktop app
   • Give it a name (e.g., "Obsidian Drive Link")
   • Click Create
6. Copy the Client ID and Client Secret

2. Configure the Plugin

1. Install and enable the plugin in Obsidian
2. Open Settings > Google Drive Folder Link
3. Paste your Client ID and Client Secret
4. Click Connect and authorize access in your browser
5. Add one or more root folders to search within using Add root folder

3. Usage

• Attach a folder: Open a note, then use the command palette ("Attach Google Drive folder...") or right-click the file and select "Attach Google Drive folder..."
• Open an attached folder: Click the link in the Properties pane, use the command palette ("Open attached Google Drive folder"), or right-click the file
• Remove a link: Delete the googleDriveFolderId and googleDriveFolderName properties from the note

Development

npm install
npm run dev