Skip to content

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

feat(connections): add google drive, docs, and sheets via composio (#5362)

Ansh Grover017b80b38c90
diff --git a/apps/screenpipe-app-tauri/components/settings/composio-card.tsx b/apps/screenpipe-app-tauri/components/settings/composio-card.tsx
index f4d7c2d48..7a28f7c52 100644
--- a/apps/screenpipe-app-tauri/components/settings/composio-card.tsx
+++ b/apps/screenpipe-app-tauri/components/settings/composio-card.tsx
@@ -25,16 +25,73 @@ const MCP_SERVER_ID = "composio";
const POLL_MS = 2000;
const MAX_POLLS = 60; // 2 minutes
-export type ComposioToolkit = "gmail" | "zoom";
+export const COMPOSIO_TOOLKITS = [
+ "gmail",
+ "zoom",
+ "googledrive",
+ "googledocs",
+ "googlesheets",
+] as const;
+export type ComposioToolkit = (typeof COMPOSIO_TOOLKITS)[number];
+export type ComposioStatusMap = Record<ComposioToolkit, boolean>;
-const TOOLKIT_LABEL: Record<ComposioToolkit, string> = {
- gmail: "Gmail",
- zoom: "Zoom",
+interface ToolkitMeta {
+ label: string;
+ provider: string;
+ /** value line above the CTA */
+ value: string;
+ /** subject phrase for the YOUR DATA fact row, e.g. "emails are" */
+ data: string;
+ /** what the AI can now do, shown in the connected state */
+ connectedNoun: string;
+}
+
+const TOOLKIT_META: Record<ComposioToolkit, ToolkitMeta> = {
+ gmail: {
+ label: "Gmail",
+ provider: "Google",
+ value: "let your AI read and search your Gmail inbox.",
+ data: "emails are",
+ connectedNoun: "recent emails",
+ },
+ zoom: {
+ label: "Zoom",
+ provider: "Zoom",
+ value: "let your AI see your Zoom meetings, recordings, and transcripts.",
+ data: "meeting data is",
+ connectedNoun: "meetings, recordings and transcripts",
+ },
+ googledrive: {
+ label: "Google Drive",
+ provider: "Google",
+ value: "let your AI search, read, and organize files across your Google Drive.",
+ data: "files are",
+ connectedNoun: "Drive files",
+ },
+ googledocs: {
+ label: "Google Docs",
+ provider: "Google",
+ value: "let your AI read, create, and edit your Google Docs.",
+ data: "documents are",
+ connectedNoun: "documents",
+ },
+ googlesheets: {
+ label: "Google Sheets",
+ provider: "Google",
+ value: "let your AI read, create, and edit your Google Sheets.",
+ data: "spreadsheets are",
+ connectedNoun: "spreadsheets",
+ },
};
-interface ComposioStatus {
- gmail: { connected: boolean; status: string | null };
- zoom: { connected: boolean; status: string | null };
+type ComposioStatus = Partial<
+ Record<ComposioToolkit, { connected: boolean; status: string | null }>
+>;
+
+function statusToMap(status: ComposioStatus): ComposioStatusMap {
+ return Object.fromEntries(
+ COMPOSIO_TOOLKITS.map((t) => [t, status[t]?.connected === true])
+ ) as ComposioStatusMap;
}
async function fetchComposioStatus(token: string): Promise<ComposioStatus | null> {
@@ -50,12 +107,12 @@ async function fetchComposioStatus(token: string): Promise<ComposioStatus | null
}
// Register (or refresh) the shared Composio MCP server entry so the agent
-// can reach gmail/zoom tools through the existing mcp-bridge. One entry
-// serves both toolkits; the Authorization header carries the user's token
-// and the org Composio key never reaches this device.
+// can reach the connected toolkits through the existing mcp-bridge. One
+// entry serves every toolkit; the Authorization header carries the user's
+// token and the org Composio key never reaches this device.
async function registerComposioMcpServer(token: string): Promise<void> {
const body = {
- name: "Composio (Gmail + Zoom)",
+ name: "Composio",
url: `${COMPOSIO_API}/mcp`,
headers: [{ name: "Authorization", value: `Bearer ${token}` }],
enabled: true,
@@ -78,30 +135,37 @@ async function removeComposioMcpServer(): Promise<void> {
export function ComposioCard({
toolkit,
+ initialConnected,
onChanged,
}: {
toolkit: ComposioToolkit;
- onChanged?: (status: { gmail: boolean; zoom: boolean }) => void;
+ /** Last known connected state from the connections section's status fetch.
+ * When provided the card renders immediately and reconciles in the
+ * background instead of blocking on its own round trip. */
+ initialConnected?: boolean;
+ onChanged?: (status: ComposioStatusMap) => void;
}) {
const { settings } = useSettings();
const token = settings.user?.token;
- const label = TOOLKIT_LABEL[toolkit];
+ const { label, provider } = TOOLKIT_META[toolkit];
- const [loaded, setLoaded] = useState(false);
- const [connected, setConnected] = useState(false);
+ const [loaded, setLoaded] = useState(initialConnected !== undefined);
+ const [connected, setConnected] = useState(initialConnected ?? false);
const [otherConnected, setOtherConnected] = useState(false);
const [waiting, setWaiting] = useState(false);
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const pollCount = useRef(0);
+ const lastStatusRef = useRef<ComposioStatusMap | null>(null);
const applyStatus = useCallback(
(status: ComposioStatus) => {
- const mine = status[toolkit].connected;
- const other = status[toolkit === "gmail" ? "zoom" : "gmail"].connected;
+ const map = statusToMap(status);
+ lastStatusRef.current = map;
+ const mine = map[toolkit];
setConnected(mine);
- setOtherConnected(other);
- onChanged?.({ gmail: status.gmail.connected, zoom: status.zoom.connected });
+ setOtherConnected(COMPOSIO_TOOLKITS.some((t) => t !== toolkit && map[t]));
+ onChanged?.(map);
return mine;
},
[toolkit, onChanged]
@@ -193,11 +257,14 @@ export function ComposioCard({
});
if (!res.ok) throw new Error("disconnect failed");
setConnected(false);
- onChanged?.({
- gmail: toolkit === "gmail" ? false : otherConnected,
- zoom: toolkit === "zoom" ? false : otherConnected,
- });
- // Keep the shared MCP entry while the other toolkit is still connected.
+ const map = {
+ ...(lastStatusRef.current ??
+ (Object.fromEntries(COMPOSIO_TOOLKITS.map((t) => [t, false])) as ComposioStatusMap)),
+ [toolkit]: false,
+ } as ComposioStatusMap;
+ lastStatusRef.current = map;
+ onChanged?.(map);
+ // Keep the shared MCP entry while any other toolkit is still connected.
if (!otherConnected) await removeComposioMcpServer();
notifyConnectionsUpdated();
} catch (e: any) {
@@ -211,16 +278,11 @@ export function ComposioCard({
// neutral "via composio" chip (rendered by connections-section); the body
// sells the feature and keeps the honest data-path detail one click away.
const valueLine = (
- <p className="text-xs text-foreground/90">
- {toolkit === "gmail"
- ? "let your AI read and search your Gmail inbox."
- : "let your AI see your Zoom meetings, recordings, and transcripts."}
- </p>
+ <p className="text-xs text-foreground/90">{TOOLKIT_META[toolkit].value}</p>
);
// Treatment 1 (design round 4): the expanded state is a labeled fact grid
// that uses the full panel width instead of a narrow text column.
- const provider = toolkit === "gmail" ? "Google" : "Zoom";
const factRows: Array<[string, React.ReactNode]> = [
[
"sign-in",
@@ -233,7 +295,7 @@ export function ComposioCard({
[
"your data",
<>
- {toolkit === "gmail" ? "emails are" : "meeting data is"} processed through
+ {TOOLKIT_META[toolkit].data} processed through
Composio&apos;s cloud (
<b className="font-medium text-foreground/80">SOC 2 certified, encrypted</b>), not
stored by screenpipe.
@@ -312,7 +374,7 @@ export function ComposioCard({
<p className="text-xs">
<Check className="h-3 w-3 inline mr-1" />
{label} connected — your AI can now read your{" "}
- {toolkit === "gmail" ? "recent emails" : "meetings, recordings and transcripts"}.
+ {TOOLKIT_META[toolkit].connectedNoun}.
</p>
{error && <p className="text-xs text-destructive">{error}</p>}
<Button
@@ -331,7 +393,7 @@ export function ComposioCard({
{waiting && (
<p className="text-[11px] text-muted-foreground flex items-center gap-1.5">
<Loader2 className="h-3 w-3 animate-spin" />
- finish signing in with {toolkit === "gmail" ? "Google" : "Zoom"} in your browser —
+ finish signing in with {provider} in your browser —
this connects automatically
</p>
)}
diff --git a/apps/screenpipe-app-tauri/components/settings/connections-section.tsx b/apps/screenpipe-app-tauri/components/settings/connections-section.tsx
index c20209c3c..6de6cff80 100644
--- a/apps/screenpipe-app-tauri/components/settings/connections-section.tsx
+++ b/apps/screenpipe-app-tauri/components/settings/connections-section.tsx
@@ -38,7 +38,7 @@ import { platform } from "@tauri-apps/plugin-os";
import { join, homeDir, tempDir, dirname } from "@tauri-apps/api/path";
import { AppleCalendarCard } from "./apple-calendar-card";
import { GoogleCalendarCard } from "./google-calendar-card";
-import { ComposioCard } from "./composio-card";
+import { ComposioCard, COMPOSIO_TOOLKITS, type ComposioStatusMap } from "./composio-card";
import { GoogleDocsCard } from "./google-docs-card";
import { IcsCalendarCard } from "./ics-calendar-card";
import { RemoteAgentCard } from "./remote-agent-card";
@@ -511,17 +511,11 @@ const INTEGRATION_ICONS: Record<string, React.ReactNode> = {
/>
</svg>
),
- gmail: (
- <svg viewBox="0 0 256 193" className="w-5 h-5" preserveAspectRatio="xMidYMid meet" aria-hidden>
- <path fill="#4285F4" d="M58.182 192.05V93.14L27.507 65.077 0 49.504v125.091c0 9.658 7.825 17.455 17.455 17.455h40.727Z"/>
- <path fill="#34A853" d="M197.818 192.05h40.727c9.659 0 17.455-7.826 17.455-17.455V49.505l-31.156 17.837-27.026 25.798v98.91Z"/>
- <path fill="#EA4335" d="m58.182 93.14-4.174-38.647 4.174-36.989L128 69.868l69.818-52.364 4.669 34.992-4.669 40.644L128 145.504z"/>
- <path fill="#FBBC04" d="M197.818 17.504V93.14L256 49.504V26.231c0-21.585-24.64-33.89-41.89-20.945l-16.292 12.218Z"/>
- <path fill="#C5221F" d="m0 49.504 26.759 20.07L58.182 93.14V17.504L41.89 5.286C24.61-7.66 0 4.646 0 26.231v23.273Z"/>
- </svg>
- ),
+ gmail: <img src="/images/gmail.svg" alt="Gmail" className="w-5 h-5" />,
"google-calendar": <img src="/images/google-calendar.svg" alt="Google Calendar" className="w-5 h-5" />,
"google-docs": <img src="/images/google-docs.svg" alt="Google Docs" className="w-5 h-5" />,
+ "google-drive": <img src="/images/google-drive.svg" alt="Google Drive" className="w-5 h-5" />,
+ "google-sheets": <img src="/images/google-sheets.svg" alt="Google Sheets" className="w-5 h-5" />,
"ics-calendar": <CalendarIcon className="h-5 w-5 text-muted-foreground" />,
"remote-agent": <img src="/openclaw-icon.svg" alt="Remote agent" className="w-5 h-5" />,
bee: <img src="/images/bee.png" alt="Bee" className="w-5 h-5 rounded" />,
@@ -756,6 +750,8 @@ export const TRY_IN_CHAT_PROMPTS: Record<string, string> = {
granola: "Show notes from my recent meetings",
zoom: "Summarize my recent Zoom calls",
gmail: "Summarize my recent emails",
+ "google-drive": "Find my recent files in Google Drive",
+ "google-sheets": "What's in my latest spreadsheet?",
krisp: "Search my meeting transcripts for action items",
excalidraw: "What's on my recent Excalidraw boards?",
whatsapp: "What were the latest messages in my WhatsApp?",
@@ -3712,9 +3708,13 @@ export function ConnectionsSection({
const [excalidrawConnected, setExcalidrawConnected] = useState(false);
const [importedSkillsCount, setImportedSkillsCount] = useState(0);
const [piExtensionCount, setPiExtensionCount] = useState(0);
- // Gmail/Zoom via Composio (managed auth through screenpipe.com; see composio-card.tsx)
+ // Composio-backed connections (managed auth through screenpipe.com; see
+ // composio-card.tsx): gmail, zoom, google drive/docs/sheets.
const { settings: composioSettings } = useSettings();
- const [composioConnected, setComposioConnected] = useState({ gmail: false, zoom: false });
+ const [composioConnected, setComposioConnected] = useState<ComposioStatusMap>(
+ () =>
+ Object.fromEntries(COMPOSIO_TOOLKITS.map((t) => [t, false])) as ComposioStatusMap
+ );
const composioToken = composioSettings.user?.token;
useEffect(() => {
if (!composioToken) return;
@@ -3723,7 +3723,12 @@ export function ConnectionsSection({
})
.then((r) => (r.ok ? r.json() : null))
.then((s) => {
- if (s) setComposioConnected({ gmail: !!s.gmail?.connected, zoom: !!s.zoom?.connected });
+ if (!s) return;
+ setComposioConnected(
+ Object.fromEntries(
+ COMPOSIO_TOOLKITS.map((t) => [t, !!s[t]?.connected])
+ ) as ComposioStatusMap
+ );
})
.catch(() => {});
}, [composioToken]);
@@ -3905,6 +3910,8 @@ export function ConnectionsSection({
{ id: "google-calendar", name: "Google Calendar", icon: "google-calendar", connected: false },
{ id: "google-docs", name: "Google Docs", icon: "google-docs", connected: false },
{ id: "gmail", name: "Gmail", icon: "gmail", connected: composioConnected.gmail },
+ { id: "google-drive", name: "Google Drive", icon: "google-drive", connected: composioConnected.googledrive },
+ { id: "google-sheets", name: "Google Sheets", icon: "google-sheets", connected: composioConnected.googlesheets },
{ id: "ics-calendar", name: "ICS Calendar", icon: "ics-calendar", connected: false },
{ id: "remote-agent", name: "Remote agent", icon: "remote-agent", connected: false },
{ id: "whatsapp", name: "WhatsApp", icon: "whatsapp", connected: false, detected: detectedConnectionIds.has("whatsapp") },
@@ -3965,7 +3972,8 @@ export function ConnectionsSection({
const googleCalTile = hardcoded.find(h => h.id === "google-calendar");
if (googleCalTile) googleCalTile.connected = googleCalendarConnected;
const googleDocsTile = hardcoded.find(h => h.id === "google-docs");
- if (googleDocsTile) googleDocsTile.connected = googleDocsConnected;
+ // Docs lights for the Composio connection OR the legacy native OAuth one.
+ if (googleDocsTile) googleDocsTile.connected = googleDocsConnected || composioConnected.googledocs;
// Zoom's dot lights for the Composio connection OR a legacy Zoom OAuth connection.
const zoomTile = apiTiles.find(t => t.id === "zoom");
if (zoomTile) zoomTile.connected = zoomTile.connected || composioConnected.zoom;
@@ -4116,11 +4124,30 @@ export function ConnectionsSection({
onConnected={() => setGoogleCalendarConnected(true)}
onDisconnected={() => { setGoogleCalendarConnected(false); notifyConnectionsUpdated(); fetchIntegrations(); }}
/>;
- case "google-docs": return <GoogleDocsCard />;
- case "gmail": return <ComposioCard toolkit="gmail" onChanged={setComposioConnected} />;
+ case "google-docs": return (
+ <div className="space-y-3">
+ <ComposioCard toolkit="googledocs" initialConnected={composioConnected.googledocs} onChanged={setComposioConnected} />
+ {/* The native Docs connector (documents + drive.file scopes) still
+ works and keeps tokens local — keep it manageable for users who
+ connected before Composio became the primary path. */}
+ {googleDocsConnected && (
+ <details>
+ <summary className="text-[11px] text-muted-foreground cursor-pointer select-none hover:text-foreground">
+ advanced: manage the legacy google docs connection
+ </summary>
+ <div className="pt-2">
+ <GoogleDocsCard />
+ </div>
+ </details>
+ )}
+ </div>
+ );
+ case "google-drive": return <ComposioCard toolkit="googledrive" initialConnected={composioConnected.googledrive} onChanged={setComposioConnected} />;
+ case "google-sheets": return <ComposioCard toolkit="googlesheets" initialConnected={composioConnected.googlesheets} onChanged={setComposioConnected} />;
+ case "gmail": return <ComposioCard toolkit="gmail" initialConnected={composioConnected.gmail} onChanged={setComposioConnected} />;
case "zoom": return (
<div className="space-y-3">
- <ComposioCard toolkit="zoom" onChanged={setComposioConnected} />
+ <ComposioCard toolkit="zoom" initialConnected={composioConnected.zoom} onChanged={setComposioConnected} />
{/* The legacy Zoom OAuth app was rejected in marketplace review, so its
authorize page is dead for new connections. Surface the old panel
only for users who still HAVE a legacy connection (to manage or
@@ -4435,7 +4462,7 @@ export function ConnectionsSection({
macOS
</span>
)}
- {(selectedTile.id === "gmail" || selectedTile.id === "zoom") && (
+ {["gmail", "zoom", "google-drive", "google-docs", "google-sheets"].includes(selectedTile.id) && (
<span className="px-2 py-0.5 text-[10px] font-mono border border-border text-muted-foreground inline-flex items-center">
via composio
</span>
diff --git a/apps/screenpipe-app-tauri/lib/constants/connections.ts b/apps/screenpipe-app-tauri/lib/constants/connections.ts
index d35e862ef..41eeadbad 100644
--- a/apps/screenpipe-app-tauri/lib/constants/connections.ts
+++ b/apps/screenpipe-app-tauri/lib/constants/connections.ts
@@ -88,6 +88,8 @@ export const CONNECTION_CATEGORY_BY_ID: Record<string, string> = {
// Documents — docs, spreadsheets, wikis & whiteboards
"google-docs": "Documents",
+ "google-drive": "Documents",
+ "google-sheets": "Documents",
confluence: "Documents",
excalidraw: "Documents",
@@ -164,6 +166,8 @@ export const CONNECTION_HARDCODED_DESCRIPTIONS: Record<string, string> = {
"google-calendar": "Search Google Calendar events with AI",
"google-docs": "Read and search your Google Docs",
gmail: "Read your Gmail inbox (via composio.dev managed auth)",
+ "google-drive": "Search and read your Google Drive files (via composio.dev managed auth)",
+ "google-sheets": "Read, create, and edit Google Sheets (via composio.dev managed auth)",
"outlook-email": "Read and send your Outlook email",
"ics-calendar": "Subscribe to any ICS calendar feed",
"remote-agent": "Run a 24/7 agent (OpenClaw, Hermes, Claude, Codex) on your VPS, wired to screenpipe",
diff --git a/apps/screenpipe-app-tauri/public/images/gmail.svg b/apps/screenpipe-app-tauri/public/images/gmail.svg
new file mode 100644
index 000000000..7da6ca5be
--- /dev/null
+++ b/apps/screenpipe-app-tauri/public/images/gmail.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192"><path fill="url(#a)" d="M146 44h38v110c0 6.627-5.373 12-12 12h-20a6 6 0 0 1-6-6z"/><path fill="#fc413d" d="M46 44H8v110c0 6.627 5.373 12 12 12h20a6 6 0 0 0 6-6z"/><path fill="url(#b)" d="M39.226 30.456c-8.033-6.752-20.018-5.714-26.77 2.319-6.752 8.032-5.714 20.017 2.319 26.77l76.078 63.949a8 8 0 0 0 10.295 0l76.078-63.95c8.032-6.752 9.07-18.737 2.318-26.77-6.752-8.032-18.737-9.07-26.769-2.318L96 78.18z"/><defs><linearGradient id="a" x1="165" x2="165" y1="44" y2="166" gradientUnits="userSpaceOnUse"><stop stop-color="#60d673"/><stop offset=".17" stop-color="#42c868"/><stop offset=".39" stop-color="#0ebc5f"/><stop offset=".62" stop-color="#00a9bb"/><stop offset=".86" stop-color="#3c90ff"/><stop offset="1" stop-color="#3186ff"/></linearGradient><linearGradient id="b" x1="8" x2="184" y1="46.13" y2="46.13" gradientUnits="userSpaceOnUse"><stop offset=".08" stop-color="#ff63a0"/><stop offset=".3" stop-color="#fc413d"/><stop offset=".5" stop-color="#fc413d"/><stop offset=".65" stop-color="#fc413d"/><stop offset=".72" stop-color="#fc5c30"/><stop offset=".86" stop-color="#feb10c"/><stop offset=".91" stop-color="#fec700"/><stop offset=".96" stop-color="#ffdb0f"/></linearGradient></defs></svg>
\ No newline at end of file
diff --git a/apps/screenpipe-app-tauri/public/images/google-docs.svg b/apps/screenpipe-app-tauri/public/images/google-docs.svg
index 5fe5e2f46..92f2e869a 100644
--- a/apps/screenpipe-app-tauri/public/images/google-docs.svg
+++ b/apps/screenpipe-app-tauri/public/images/google-docs.svg
@@ -1,5 +1,25 @@
-<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 48 48">
- <path fill="#2196F3" d="M37 45H11c-1.657 0-3-1.343-3-3V6c0-1.657 1.343-3 3-3h19l10 10v29c0 1.657-1.343 3-3 3z"/>
- <path fill="#BBDEFB" d="M40 13H30V3z"/>
- <path fill="#E3F2FD" d="M15 23h18v2H15zm0 4h18v2H15zm0 4h14v2H15z"/>
+<svg width="192" height="192" viewBox="0 0 192 192" fill="none" xmlns="http://www.w3.org/2000/svg">
+<mask id="mask0_37242_8762" style="mask-type:alpha" maskUnits="userSpaceOnUse" x="32" y="8" width="128" height="176">
+<path d="M130.334 184L61.6 184C52.6565 184 48.1848 184 44.6375 182.596C39.5029 180.563 35.4374 176.497 33.4045 171.362C32 167.815 32 163.343 32 154.4L32 37.6C32 28.6565 32 24.1848 33.4045 20.6375C35.4374 15.5029 39.5029 11.4374 44.6375 9.40447C48.1848 8 52.6565 8 61.6 8L100 8L154.793 62.7933L154.793 62.7934C156.454 64.4543 157.285 65.2848 157.923 66.2239C158.845 67.5811 159.479 69.1131 159.785 70.725C159.997 71.8404 159.997 73.0264 159.995 75.3985C159.96 124.317 159.938 124.799 159.937 154.366C159.937 163.332 159.937 167.816 158.532 171.363C156.499 176.498 152.434 180.562 147.299 182.596C143.752 184 139.279 184 130.334 184Z" fill="#3186FF"/>
+</mask>
+<g mask="url(#mask0_37242_8762)">
+<path d="M159.94 184L31.9999 184L31.9999 8.00001L99.9999 8L159.999 68L159.94 184Z" fill="#3186FF"/>
+<g filter="url(#filter0_f_37242_8762)">
+<path d="M43 192H149V70.2271V20H43V192Z" fill="url(#paint0_linear_37242_8762)"/>
+</g>
+</g>
+<path d="M154.995 62.9951C152.489 61.1143 149.375 60 146 60H112.8C105.731 60 100 54.2692 100 47.2002V8L154.995 62.9951Z" fill="#76BBFF"/>
+<rect x="64.001" y="114" width="64" height="12" rx="6" fill="white"/>
+<rect x="64.001" y="143" width="48" height="12" rx="6" fill="white"/>
+<defs>
+<filter id="filter0_f_37242_8762" x="31" y="8" width="130" height="196" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
+<feFlood flood-opacity="0" result="BackgroundImageFix"/>
+<feBlend mode="normal" in="SourceGraphic" in2="BackgroundImageFix" result="shape"/>
+<feGaussianBlur stdDeviation="6" result="effect1_foregroundBlur_37242_8762"/>
+</filter>
+<linearGradient id="paint0_linear_37242_8762" x1="96" y1="59.2839" x2="54.6124" y2="171.338" gradientUnits="userSpaceOnUse">
+<stop offset="0.33" stop-color="#3186FF"/>
+<stop offset="1" stop-color="#A9A8FF"/>
+</linearGradient>
+</defs>
</svg>
diff --git a/apps/screenpipe-app-tauri/public/images/google-drive.svg b/apps/screenpipe-app-tauri/public/images/google-drive.svg
new file mode 100644
index 000000000..6c9065b30
--- /dev/null
+++ b/apps/screenpipe-app-tauri/public/images/google-drive.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" viewBox="0 0 192 192" fill="none"><mask id="a" width="168" height="154" x="12" y="18" maskUnits="userSpaceOnUse" style="mask-type:alpha"><path fill="#b43333" d="M63.09 37c14.626-25.333 51.193-25.334 65.819 0l45.033 78c14.626 25.334-3.657 57.001-32.91 57.001H50.967c-29.253 0-47.536-31.667-32.91-57.001z"/></mask><g mask="url(#a)"><path fill="url(#b)" d="M206.905 172.02h-91.888l-19.015-32.934 45.944-79.578z"/><path fill="url(#c)" d="M-14.919 172.006 50.04 59.494v.002L31.032 92.422h38.02L115 172.004l-129.918.001z"/><path fill="url(#d)" d="M96.007-20.085 141.954 59.5l-19.011 32.928H31.048z"/></g><defs><linearGradient id="b" x1="193.6" x2="103.09" y1="165.6" y2="111.21" gradientUnits="userSpaceOnUse"><stop offset=".09" stop-color="#ffe921"/><stop offset="1" stop-color="#fec700"/></linearGradient><linearGradient id="c" x1="114.4" x2="15.53" y1="181.61" y2="121.8" gradientUnits="userSpaceOnUse"><stop offset=".15" stop-color="#a9a8ff"/><stop offset=".33" stop-color="#6d97ff"/><stop offset=".48" stop-color="#3186ff"/></linearGradient><linearGradient id="d" x1="128.88" x2="28.7" y1="37.88" y2="84.64" gradientUnits="userSpaceOnUse"><stop offset=".55" stop-color="#0ebc5f"/><stop offset=".85" stop-color="#78c9ff"/></linearGradient></defs></svg>
\ No newline at end of file
diff --git a/apps/screenpipe-app-tauri/public/images/google-sheets.svg b/apps/screenpipe-app-tauri/public/images/google-sheets.svg
new file mode 100644
index 000000000..64cac115b
--- /dev/null
+++ b/apps/screenpipe-app-tauri/public/images/google-sheets.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="192" height="192" fill="none" viewBox="0 0 192 192"><path fill="#009954" d="M8 74.6c0-8.943 0-13.415 1.404-16.962a20 20 0 0 1 11.234-11.233C24.185 45 28.656 45 37.6 45h60.8c8.943 0 13.415 0 16.962 1.404a20 20 0 0 1 11.234 11.234C128 61.185 128 65.656 128 74.6v42.8c0 8.943 0 13.415-1.404 16.962a20 20 0 0 1-11.234 11.234C111.815 147 107.343 147 98.4 147H37.6c-8.943 0-13.415 0-16.963-1.404a20 20 0 0 1-11.233-11.234C8 130.815 8 126.343 8 117.4z"/><mask id="a" width="160" height="128" x="24" y="32" maskUnits="userSpaceOnUse" style="mask-type:alpha"><rect width="160" height="128" x="24" y="32" fill="#0ebc5f" rx="20"/></mask><g mask="url(#a)"><path fill="#0ebc5f" d="M24 32h160v128H24z"/><g filter="url(#b)"><rect width="144" height="102" fill="url(#c)" rx="25.6" transform="matrix(1 0 0 -1 8 147)"/></g></g><path stroke="#fff" stroke-linecap="round" stroke-width="12" d="M80 121h84m-20 19V76"/><defs><linearGradient id="c" x1="122.24" x2="20.76" y1="43.31" y2="43.31" gradientUnits="userSpaceOnUse"><stop stop-color="#0ebc5f"/><stop offset=".95" stop-color="#78c9ff"/></linearGradient><filter id="b" width="168" height="126" x="-4" y="33" color-interpolation-filters="sRGB" filterUnits="userSpaceOnUse"><feFlood flood-opacity="0" result="BackgroundImageFix"/><feBlend in="SourceGraphic" in2="BackgroundImageFix" result="shape"/><feGaussianBlur result="effect1_foregroundBlur_37435_8174" stdDeviation="6"/></filter></defs></svg>
\ No newline at end of file
diff --git a/apps/screenpipe-app-tauri/src-tauri/assets/extensions/connection-gate.ts b/apps/screenpipe-app-tauri/src-tauri/assets/extensions/connection-gate.ts
index 41ab4b1b4..8955d66bc 100644
--- a/apps/screenpipe-app-tauri/src-tauri/assets/extensions/connection-gate.ts
+++ b/apps/screenpipe-app-tauri/src-tauri/assets/extensions/connection-gate.ts
@@ -104,8 +104,10 @@ async function findMcpProviderServer(
}
async function enrichConnection(connection: ConnectionItem, signal?: AbortSignal): Promise<ConnectionItem> {
- const composio = await composioEnrichment(connection.id, signal);
- if (composio) return { ...connection, ...composio };
+ if (!shouldSkipComposioEnrichment(connection)) {
+ const composio = await composioEnrichment(connection.id, signal);
+ if (composio) return { ...connection, ...composio };
+ }
const server = await findMcpProviderServer(connection.id, signal);
if (!server) return connection;
return {
@@ -122,7 +124,20 @@ async function enrichConnection(connection: ConnectionItem, signal?: AbortSignal
// presence IS the connected signal. Gmail has no /connections entry at all
// (it is a frontend-only tile), so without this the gate tells the model
// Gmail doesn't exist even though the tools are one sp_mcp_call away.
-const COMPOSIO_TOOLKIT_IDS = new Set(["gmail", "zoom"]);
+// Connection id → display metadata for every Composio-backed connection.
+// Ids match the app's tile/connection ids (kebab-case), not Composio's
+// toolkit slugs — the agent only needs the MCP server id to act.
+const COMPOSIO_CONNECTIONS: Record<
+ string,
+ { name: string; category: string }
+> = {
+ gmail: { name: "Gmail", category: "Communication" },
+ zoom: { name: "Zoom", category: "Meetings" },
+ "google-drive": { name: "Google Drive", category: "Documents" },
+ "google-docs": { name: "Google Docs", category: "Documents" },
+ "google-sheets": { name: "Google Sheets", category: "Documents" },
+};
+const COMPOSIO_TOOLKIT_IDS = new Set(Object.keys(COMPOSIO_CONNECTIONS));
const COMPOSIO_URL_RE = /^https:\/\/(www\.)?(screenpipe\.com|screenpi\.pe)\/api\/composio\/mcp\/?$/;
async function findComposioServer(signal?: AbortSignal): Promise<McpServerItem | null> {
@@ -148,16 +163,24 @@ async function composioEnrichment(
};
}
+// Native connections that overlap a Composio toolkit (google-docs). When the
+// native one is already connected, keep its proxy path authoritative and
+// don't rewrite it to MCP — the user may never have connected the Composio
+// variant, and the native proxy is free and local.
+function shouldSkipComposioEnrichment(connection: ConnectionItem): boolean {
+ return connection.connected === true && !connection.mcp;
+}
+
function composioSyntheticConnection(id: string, serverId: string): ConnectionItem {
- const name = id === "gmail" ? "Gmail" : "Zoom";
+ const meta = COMPOSIO_CONNECTIONS[id] ?? { name: id, category: "Productivity" };
return {
id,
- name,
+ name: meta.name,
connected: true,
mcp: true,
mcp_server_id: serverId,
- category: id === "gmail" ? "Communication" : "Meetings",
- description: `${name} via Composio managed auth. Discover tools with sp_mcp_list_tools (server_id "${serverId}"), then call them with sp_mcp_call — e.g. GMAIL_* / ZOOM_* tools through COMPOSIO_SEARCH_TOOLS and COMPOSIO_MULTI_EXECUTE_TOOL.`,
+ category: meta.category,
+ description: `${meta.name} via Composio managed auth. Discover tools with sp_mcp_list_tools (server_id "${serverId}"), then call them with sp_mcp_call — e.g. GMAIL_* / GOOGLEDRIVE_* / GOOGLEDOCS_* / GOOGLESHEETS_* / ZOOM_* tools through COMPOSIO_SEARCH_TOOLS and COMPOSIO_MULTI_EXECUTE_TOOL.`,
};
}
diff --git a/docs/mintlify/docs-mintlify-mig-tmp/connection-reference.mdx b/docs/mintlify/docs-mintlify-mig-tmp/connection-reference.mdx
index 029a39460..bcfb8b65c 100644
--- a/docs/mintlify/docs-mintlify-mig-tmp/connection-reference.mdx
+++ b/docs/mintlify/docs-mintlify-mig-tmp/connection-reference.mdx
@@ -33,6 +33,7 @@ this works for all API key, webhook, and custom credential fields.
| webhook URL | n8n, Make, Zapier, Pushover, ntfy, Resend | best for one-way notifications or workflow triggers |
| local path | Obsidian, Logseq | keeps notes local |
| custom/private CA | Bee | screenpipe includes the required trust configuration for the provider |
+| managed OAuth via Composio | Gmail, Zoom, Google Drive, Google Docs, Google Sheets | one-click sign-in managed by composio.dev (SOC 2), available on every plan. Sign-in and data access run through Composio's cloud, and the agent reaches these through the shared Composio MCP server (sp_mcp tools), not the connection proxy |
## credential storage
@@ -52,8 +53,8 @@ The app registry currently includes these connection IDs:
| category | integrations |
| --- | --- |
-| communication | Slack, Discord, Email (SMTP), Outlook, Telegram, WhatsApp, Microsoft Teams, Zoom |
-| productivity | Notion, Obsidian, Google Calendar, Google Docs, Microsoft 365, Logseq, Workflowy, Airtable, Confluence, Odoo, Mochi, Hermes |
+| communication | Slack, Discord, Email (SMTP), Gmail (via Composio), Outlook, Telegram, WhatsApp, Microsoft Teams, Zoom (via Composio) |
+| productivity | Notion, Obsidian, Google Calendar, Google Docs, Google Drive (via Composio), Google Sheets (via Composio), Microsoft 365, Logseq, Workflowy, Airtable, Confluence, Odoo, Mochi, Hermes |
| project management | Linear, Jira, Asana, Monday.com, Trello, ClickUp, Todoist, Cal.com, Calendly |
| CRM and support | HubSpot, Salesforce, Pipedrive, Intercom, Zendesk, Bitrix24 |
| developer and ops | GitHub, Sentry, Vercel, Supabase, PostHog |