Skip to main content
Fliiq integrates with Google in two distinct ways. Understanding the difference is important:

Fliiq's Own Channel

Give Fliiq its own Gmail address so people can email it directly — like texting a friend. Fliiq receives messages and responds from its own inbox.This is a channel — a way to talk to Fliiq.Set up Fliiq’s email channel →

Managing Your Accounts

Authorize Fliiq to access your Gmail, Calendar, Drive, Sheets, Docs, and Slides. Fliiq manages your inbox, schedules meetings, organizes files, builds spreadsheets, and drafts documents.This is account access — Fliiq acts as your personal assistant.Keep reading below ↓
The rest of this guide covers the second use case: giving Fliiq access to your Google accounts so it can manage your email, calendar, and Google Workspace files.

​
Prerequisites

You need a Google Cloud project with OAuth credentials. This is a one-time setup.

​
1. Create a Google Cloud Project

  1. Go to the Google Cloud Console
  2. Create a new project (or select an existing one)
  3. Name it something like “Fliiq”

​
2. Enable APIs

Enable these APIs in your project: You only need to enable the APIs you plan to use. Gmail and Calendar are the most common starting point.

​
3. Create OAuth Credentials

  1. Go to APIs & Services → Credentials
  2. Click Create Credentials → OAuth client ID
  3. Application type: Web application
  4. Add http://localhost:8080/callback as an Authorized redirect URI
  5. Copy your Client ID and Client Secret

​
4. Add to .env

.env
OAuth consent screen: If prompted, configure the consent screen as “External” for testing. Add your own Gmail addresses as test users. You don’t need to publish the app — test mode works fine for personal use.

​
Authorize Your Accounts

Once OAuth credentials are configured, authorize each Google account you want Fliiq to access:
This opens your browser to the Google consent screen. Sign in with the Google account you want to authorize, grant permission, and you’re done. Tokens are saved to ~/.fliiq/google_tokens.json and auto-refresh. Authorize as many accounts as you need:
After each authorization, Fliiq prompts you to add the account to your user profile with a label (personal, work, etc.).

​
View Authorized Accounts

Lists all Google accounts you’ve authorized.

​
User Profile

When you authorize accounts, Fliiq adds them to ~/.fliiq/user.yaml:
This profile is loaded into the agent’s system prompt every session, so when you say “check my work email” or “look at my personal calendar,” Fliiq knows which account to use.

​
What Fliiq Can Do With Your Accounts

​
Gmail

With access to your Gmail, Fliiq can:
  • Read emails — fetch your inbox, filter by unread/read/all; extracts Message-ID, In-Reply-To, References, To, and CC headers for full threading context
  • Send emails — compose and send from your address, with support for cc, bcc, in_reply_to, and references for proper conversation threading
  • Mark as read — clear unread status on processed emails
  • Archive — move emails from Inbox to All Mail
  • Delete — move emails to Trash
  • Daemon email listener — when Gmail credentials are configured, the daemon polls your inbox every 60 seconds and routes inbound messages to the agent automatically. Disable with FLIIQ_EMAIL_LISTENER=0. Check status with fliiq daemon status (reports Email: active/inactive).
All email skills accept a gmail_address parameter to specify which authorized account to use. If you don’t specify, Fliiq uses the first authorized account.
See the Gmail Assistant example for a full walkthrough.

​
Google Calendar

With access to your Calendar, Fliiq can:
  • List calendars — discover all your calendars (personal, work, shared, subscribed)
  • List events — fetch events within any time range on any calendar
  • Create events — schedule meetings with attendees, location, agenda, and optional Google Meet link
  • Update events — change time, title, attendees, or details (auto-notifies attendees); add a Meet link to existing events
  • Delete events — cancel events (auto-notifies attendees)
The calendar skill supports multi-calendar operations. Fliiq can check availability across your personal and work calendars, then schedule on the right one:
See the Calendar Assistant example for a full walkthrough.

​
Google Drive

With access to your Drive, Fliiq can:
  • List files — browse folders and see what’s in them
  • Search files — find files by name, type, or content
  • Upload files — add new files to Drive (plain text or base64, max 5MB)
  • Export files — export Google Docs/Sheets/Slides to PDF, CSV, and other formats
  • Create folders — organize your Drive structure
  • Delete files — move files to Trash

​
Google Sheets

With access to Sheets, Fliiq can:
  • Create spreadsheets — start new spreadsheets from scratch
  • Read cell ranges — fetch data in A1 notation (e.g. Sheet1!A1:D10)
  • Write cell ranges — update data in specific cells
  • Append rows — add new rows to existing sheets

​
Google Docs

With access to Docs, Fliiq can:
  • Create documents — start new documents
  • Read documents — fetch document content
  • Insert text — add content at specific positions
  • Batch update — apply multiple formatting and content updates at once

​
Google Slides

With access to Slides, Fliiq can:
  • Create presentations — start new slide decks
  • Read presentations — fetch slide content and structure
  • Add slides — insert new slides with specific layouts
  • Insert text — add content to shapes and text boxes
  • Batch update — apply multiple slide updates at once

​
How Authentication Works

Fliiq uses a smart resolution order for credentials:
  1. OAuth first — if you’ve authorized accounts via fliiq google auth, Fliiq uses those tokens. They auto-refresh and give access to both Gmail and Calendar.
  2. App password fallback — if no OAuth tokens exist, Fliiq falls back to the GMAIL_ADDRESS / GMAIL_APP_PASSWORD env vars (Gmail only, no Calendar).
For the best experience, use OAuth. It unlocks Calendar access and is more secure than app passwords.

​
Fliiq’s Own Email vs Your Email

A quick reference for how Fliiq decides which account to use: Fliiq’s system prompt includes both its own identity (bot email) and your user profile (authorized accounts), so it understands the context naturally.