Skip to main content
Glama
wildfly8

Google Drive Agentic Retrieval MCP

by wildfly8

Google Drive Agentic Retrieval MCP

Read-only agentic retrieval over Google Drive and Google Docs/Sheets/Slides, served by a stateless MCP on Cloud Run, for any MCP-compatible reasoning agent.

This repository is developed with Spec-Kit spec-driven development. Governing principles live in .specify/memory/constitution.md and bind every subsequent spec, plan, task list, and implementation.

Constitution (ratified v1.0.0)

Google Drive is the sole source of truth. The MCP is a secure, deterministic, ephemeral evidence-acquisition layer. The calling agent owns reasoning and the retrieval loop. v1 is read-only, single Google identity per deployment, and does not require an application-owned RAG index.

See the constitution for the full invariant set (Articles I–XV).

Spec-Driven Development

Cursor skills are installed under .cursor/skills/. Use them in this order:

  1. /speckit-constitution — project principles (done: v1.0.0)

  2. /speckit-specify — what to build (done: access control + retrieval core)

  3. /speckit-clarify — optional; de-risk underspecified areas (done: session 2026-09-08)

  4. /speckit-plan — how to build it (done: access control + retrieval core)

  5. /speckit-tasks — actionable implementation tasks (done: both features)

  6. /speckit-analyze — optional; cross-artifact consistency (done: 2026-09-08; remediations and plan sync applied)

  7. /speckit-implement — execute the tasks

  8. /speckit-converge — compare the codebase to spec/plan/tasks and append remaining work

Feature specs (ready for implementation):

Repeat implement and converge until converge reports Converged.

The Specify CLI (specify-cli 1.0.4) initialized this project with the cursor-agent integration and bash scripts. Refresh managed files with specify integration upgrade after upgrading the CLI.

Shared pickup state for the next Cloud Agent:

  • .specify/memory/project-status.md — current SDD phase

  • .cursor/rules/spec-kit-sdd.mdc — always-on constitution and next-step rules

  • .cursor/environment.json — installs uv and specify-cli on Cloud Agent boot

Out of v1 scope

Multi-tenant access, write capability, persistent caches, and semantic/vector retrieval are MAJOR constitutional changes (Article XIV) and MUST be specified before any implementation work.