gdocs-daily-mcp-remote
gdocs-daily-mcp-remote
HTTP MCP remote server that reads Google Docs daily notes, deployed on the pal-e cluster. First MCP remote to reach production. Enables conversational daily note review from Claude.ai iOS.
User Stories
| Key | Story Note | Success Metric |
|---|---|---|
| <code>mobile-daily-review</code> | <a href="/notes/story-gdocs-daily-mobile-daily-review">story-gdocs-daily-mobile-daily-review</a> | Open Claude.ai on iPhone, ask about today's note, get accurate summary in <5s |
Architecture
Three-note architecture triplet:
arch:mcp-server— Domain Model — Google Docs entities, OAuth session, MCP tool surfacearch:oauth-proxy— Data Flow — 3-party OAuth dance, daily note retrieval sequence, not-found handlingarch:k8s-deploy— Deployment — Tailscale funnel, k8s namespace, Harbor/ArgoCD pipeline, onboarding checklist
Key components for
arch: labels on tickets:| arch: label | Component | Diagram |
|---|---|---|
| <code>arch:mcp-server</code> | FastMCP + Starlette server, tool definitions | Domain + Data Flow |
| <code>arch:oauth-proxy</code> | mcp-remote-auth integration, token store | Data Flow |
| <code>arch:google-docs-api</code> | Drive search + Docs content extraction | Domain + Data Flow |
| <code>arch:k8s-deploy</code> | Namespace, deployment, PVC, secrets, funnel | Deployment |
| <code>arch:ci-pipeline</code> | Woodpecker, Kaniko, Harbor, ArgoCD updater | Deployment |
| <code>arch:terraform</code> | pal-e-services onboarding entry | Deployment |
Acceptance Criteria
- MCP remote server responds to Claude.ai Streamable HTTP MCP requests at
https://gdocs-daily-mcp-remote.tail5b443a.ts.net - OAuth flow grants Google Docs read access and persists refresh token across pod restarts
get_daily_note()tool returns today's note content;get_daily_note(date="MM-DD-YYYY")returns a specific date's note- Missing notes return a clear message, not an error
- Full GitOps pipeline: push to Forgejo main → Woodpecker → Harbor → ArgoCD → running pod
- Claude.ai iOS can be configured with the MCP URL and use the tool without additional setup
Kanban
Board items below. Tickets are Forgejo issues scoped to <5 minutes of agent work.