Google Drive Agentic Retrieval MCP
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:
/speckit-constitution— project principles (done: v1.0.0)/speckit-specify— what to build (done: access control + retrieval core)/speckit-clarify— optional; de-risk underspecified areas (done: session 2026-09-08)/speckit-plan— how to build it (done: access control + retrieval core)/speckit-tasks— actionable implementation tasks (done: both features)/speckit-analyze— optional; cross-artifact consistency (done: 2026-09-08; remediations and plan sync applied)/speckit-implement— execute the tasks/speckit-converge— compare the codebase to spec/plan/tasks and append remaining work
Feature specs (ready for implementation):
Access Control Boundary — who may act, and on what authority
Retrieval Core — discover, read, exact-search once a call is cleared
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— installsuvandspecify-clion 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.