CLOVECLOVE· Connections
← Back to Connections

OAuth setup guide

One-time per provider: register Clove in their developer portal, paste keys into website/.env, restart npm run dev. Each customer still clicks Connect and logs in — tokens go to Supabase, data syncs automatically for KB connectors.

Before connecting

  1. Run SQL in Supabase: oauth_connections.sql, connector_data.sql, connector_documents.sql
  2. Check readiness: /api/connectors/ready
  3. Restart dev server after editing .env

Providers (do in order)

1

Slack

auto KB sync

.env: SLACK_CLIENT_ID, SLACK_CLIENT_SECRET · Open developer portal →

  1. Create app → From scratch
  2. OAuth redirect: http://localhost:3000/api/connect/slack/callback
  3. Bot scopes: channels:history, channels:read, groups:read, users:read
  4. Install app to workspace
  5. Copy Client ID + Client Secret to website/.env
  6. Connect in Clove → invite bot to channels → Sync KB
2

Notion

auto KB sync

.env: NOTION_CLIENT_ID, NOTION_CLIENT_SECRET · Open developer portal →

  1. New integration → Public (OAuth enabled)
  2. Redirect: http://localhost:3000/api/connect/notion/callback
  3. Copy OAuth client ID + secret to .env
  4. In Notion: share pages with the Clove integration
  5. Connect in Clove
3

GitHub

auto KB sync

.env: GITHUB_CLIENT_ID, GITHUB_CLIENT_SECRET · Open developer portal →

  1. OAuth Apps → New OAuth App
  2. Callback: http://localhost:3000/api/connect/github/callback
  3. Copy Client ID + Client Secret to .env
  4. Connect in Clove → issues/PRs sync to connector_documents
4

Google (Gmail + Drive)

auto KB sync

.env: GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET · Open developer portal →

  1. Enable Gmail API + Google Drive API
  2. OAuth consent screen → add test users
  3. Create OAuth Web client
  4. Redirects: http://localhost:3000/api/connect/gmail/callback and .../google-drive/callback
  5. Connect Gmail and Google Drive separately in Clove
5

Microsoft (Teams / Outlook)

.env: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET · Open developer portal →

  1. App registrations → New → Web redirect URIs per product
  2. Create client secret
  3. Add Graph API permissions
  4. Copy Application ID + secret to .env

Full doc with Atlassian, Linear, production URLs: website/docs/CONNECTOR_OAUTH_SETUP.md