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
GOOGLE_CLIENT_ID=your-client-id.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-your-client-secret
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: 
fliiq google auth
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: 
fliiq google auth    # Authorize your personal Gmail
fliiq google auth    # Authorize your work Gmail (sign in with work account)
After each authorization, Fliiq prompts you to add the account to your user profile with a label (personal, work, etc.).

​
View Authorized Accounts

fliiq google accounts
Lists all Google accounts you’ve authorized.

​
User Profile

When you authorize accounts, Fliiq adds them to ~/.fliiq/user.yaml: 
name: Alice Doe
emails:
  - address: alice@gmail.com
    label: personal
  - address: alice.work@company.com
    label: work
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. 
"Check my work email for unread messages"
"Send a reply to Alice's email from my personal account"
"Reply to that email and CC bob@example.com"
"Archive all the newsletters in my inbox"
"Delete the spam emails you found"
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: 
"What's on my calendar today?"
"Find a free 30-minute slot this week across both my work and personal calendars"
"Schedule a dentist appointment for Tuesday at 2pm on my personal calendar"
"Move tomorrow's standup to 10am and add Jake to the invite"
"Schedule a team sync for Thursday at 3pm and add a Google Meet link"
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
"Find all PDFs in my project folder on Drive"
"Upload this report to my shared team folder"
"Export the Q4 budget spreadsheet as a CSV"

​
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
"Create a spreadsheet tracking this week's expenses"
"Read the data in the Sales sheet from A1 to F50"
"Append today's metrics to the tracking spreadsheet"

​
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
"Create a meeting notes doc for today's standup"
"Read the project brief and summarize the key points"

​
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
"Create a presentation summarizing last quarter's metrics"
"Add a new slide with the project timeline"

​
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:
When you say…Fliiq uses…Configured via
”Check my email”Your authorized Gmail (OAuth)fliiq google auth
”Send from my work email”Your work Gmail (OAuth)fliiq google auth + user.yaml label
”Check your inbox” / “Check Fliiq’s email”Fliiq’s own bot emailFLIIQ_GMAIL_ADDRESS in .env
”What’s on my calendar?”Your Google Calendar (OAuth)fliiq google auth
Fliiq’s system prompt includes both its own identity (bot email) and your user profile (authorized accounts), so it understands the context naturally.