Skip to content

Replace split Google integration recipes with unified google-tools-mcp #126

@ElliotDrel

Description

@ElliotDrel

Problem

gbrain currently integrates with Google services through three separate recipes (credential-gatewayemail-to-braincalendar-to-brain), each requiring sequential setup, custom Node.js collector scripts generated by the agent, and independent cron jobs.

This approach has several limitations:

  • ~55 minutes of setup across three recipe walkthroughs before a single email is ingested
  • Only 2 of 9+ Google services covered — Gmail and Calendar, both read-only
  • No access to Drive, Docs, Sheets, Forms, or Slides — the agent can't search Drive for a shared doc before a meeting, pull data from a tracking spreadsheet, or draft a reply to an email
  • Custom collector code must be generated from scratch — pagination, dedup, noise filtering, state persistence, and cron scheduling are all bespoke per recipe
  • Two competing auth paths (ClawVisor vs direct OAuth) create decision overhead at every setup step
  • Silent cron failures — if a collector breaks, data stops flowing and the heartbeat system only detects it after 24 hours

Proposal

Replace the split recipe approach with google-tools-mcp — a unified MCP server that provides 153 tools across Drive, Docs, Sheets, Gmail, Calendar, Forms, and Slides with a single OAuth flow.

Installation is one command:

claude mcp add -s user google -- npx -y google-tools-mcp

Setup is one wizard:

npx -y google-tools-mcp setup

What changes

Dimension Current (3 recipes) Proposed (1 MCP server)
Setup time ~55 min ~5 min
Google services 2 (Gmail, Calendar read-only) 7 (Gmail, Calendar, Drive, Docs, Sheets, Forms, Slides — read + write)
Tool count ~6 custom operations 153
Read/Write Read-only Full read + write
Auth 2 competing paths, manual scope management Single OAuth, auto-refresh
Cron jobs 3+ 0 (on-demand tool calls)
Custom code to maintain Collectors, state files, dedup logic Zero
Multi-account Manual authuser tracking Built-in via GOOGLE_MCP_PROFILE

New capabilities unlocked

  • Drive search — find shared documents, read PDFs and Word docs directly
  • Docs integration — read and edit Google Docs natively (including markdown support)
  • Sheets integration — pull structured data from spreadsheets, write back results
  • Gmail write — draft, send, and reply to emails from brain context
  • Calendar write — create, update, and manage events
  • Forms — read responses, create forms programmatically
  • Slides — read presentation content for meeting/board prep

Architectural fit

The "code for data, LLMs for judgment" pattern is preserved — MCP tools are the deterministic data layer (handling pagination, auth, API calls reliably). The agent's judgment role (entity detection, brain enrichment, classification) is unchanged. The pattern just moves from custom Node.js collectors to maintained MCP tools.

Migration path

  1. Add google-tools-mcp as a recommended MCP server (new recipe or plugin config)
  2. Deprecate credential-gateway.md, email-to-brain.md, calendar-to-brain.md with pointers to the new setup
  3. meeting-sync.md (Circleback) is unaffected

Links

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions