Connecting Integrations

InfuseOS becomes truly powerful when connected to your favorite tools. This guide shows you how to set up integrations with Google Workspace services.

Available Integrations

InfuseOS currently supports these integrations:

Connecting Google Services

All Google integrations use the same connection flow:

Permissions Explained

When you connect each integration, Google will show you what permissions InfuseOS is requesting:

Gmail Permissions

• Read, compose, and send emails
• View email metadata (sender, subject, date)
• Manage drafts

Calendar Permissions

• View and manage your calendar
• See your events
• Create and modify events

Drive Permissions

• View and manage files in your Drive
• Download file contents
• Upload new files

Docs Permissions

• View and manage your documents
• Create new documents
• Edit existing documents

Managing Connected Integrations

Viewing Connection Status

Go to Settings → Integrations to see:

• Which integrations are connected
• Connection status (active, expired, error)
• Last used date

Disconnecting an Integration

To remove an integration:

1. Go to Settings → Integrations
2. Find the integration you want to disconnect
3. Click Disconnect
4. Confirm the disconnection

Reconnecting Expired Connections

OAuth tokens can expire after a period of time. If a connection expires:

1. You'll see an error message when trying to use that integration
2. Go to Settings → Integrations
3. Click Reconnect on the expired integration
4. Complete the OAuth flow again

Using Integrations in Chat

Once connected, you can use integrations naturally in conversation:

Gmail Examples

"Search my inbox for emails from Sarah"
"Send an email to john@example.com about the meeting tomorrow"
"Show my unread emails"

Calendar Examples

"What's on my calendar today?"
"Schedule a meeting with the team on Friday at 2pm"
"Find a free slot next week for a 1-hour call"

Drive Examples

"Find all PDFs in my Drive"
"Read the contents of 'Q4 Report'"
"Upload this document to my Projects folder"

Docs Examples

"Create a new doc called 'Meeting Notes'"
"Add a summary section to my report"
"Share the proposal doc with john@example.com"

Approval System

For security, some actions require your explicit approval before execution:

Actions Requiring Approval

• ✅ Sending emails
• ✅ Creating/updating calendar events
• ✅ Uploading/updating files
• ✅ Sharing documents

Actions Without Approval

• ❌ Searching/reading emails
• ❌ Viewing calendar events
• ❌ Listing/reading files
• ❌ Reading documents

When approval is needed, you'll see an Approve or Deny button before the action is executed.

Troubleshooting

"Integration not connected" Error

If you see this error:

1. Go to Settings → Integrations
2. Check if the integration shows as connected
3. If not, click Connect and complete the OAuth flow

"Token expired" Error

Your OAuth token may have expired:

1. Go to Settings → Integrations
2. Click Reconnect on the affected integration
3. Complete the OAuth flow again

"Permission denied" Error

This can happen if:

• You didn't grant all requested permissions
• Your Google Workspace admin has restricted third-party access

Try disconnecting and reconnecting, ensuring you click Allow on all permission requests.

What's Next?

Now that your integrations are connected, explore what you can do: