Gmail
Connect Gmail to Project88 — read, search, send, and label emails from any agent.
The Gmail integration connects an authenticated Gmail account to your org via Composio. Once connected, every agent in the org has access to Gmail tools by default (you can scope them per agent on the Tools tab).
Connect
⌘K→ Settings → Connections- Search "Gmail" in the catalog (900+ toolkits are surfaced dynamically
via the
composio-authEdge Function v6). - Click Connect. An OAuth popup opens and is closed by a static
public/oauth-callback.htmlpage thatpostMessages the result back. - The tokens are stored encrypted in Supabase Vault via the
insert_integrationRPC. The plaintext token never reaches your browser.
You'll see Gmail in your Connections list with a "Connected" status.
Tools exposed
The integration unlocks Gmail tools dynamically. Common ones include:
| Tool | What it does |
|---|---|
GMAIL_FETCH_EMAILS | Search / list emails matching a query |
GMAIL_SEND_EMAIL | Send a new email |
GMAIL_REPLY_TO_EMAIL | Reply to a thread |
GMAIL_CREATE_LABEL | Create a Gmail label |
GMAIL_LABEL_THREAD | Apply a label |
The proxy applies description overrides to about a dozen of these tools so the LLM picks them up reliably — Composio's stock descriptions are sometimes generic and the LLM ignores them.
Auto-fallback to Outlook
If an agent tries Gmail tools and there's no Gmail connection, the proxy auto-falls-back to the equivalent Outlook tools when an Outlook integration exists. The user-facing experience is "the agent reads your email" without the user having to know which provider is connected.
Inbox mode
Once Gmail is connected, the Inbox mode is populated automatically — three-panel email client with folders, labels, search, attachments, and inline reply.
Disconnect
Settings → Connections → Disconnect on the Gmail card. The integration row is soft-deleted; the Vault secret is revoked.