Gmail Attachments Mcp

communication MCP Server

Self-hosted MCP server giving Claude (and any MCP client) read-only access to your Gmail attachments — list, download, OCR. FastAPI + FastMCP + Docker.

Verified
communicationcommunicationdocker
6 views0 stars0 forksMIT

Why This Matters

Discovered via github-topic:model-context-protocol and last synced 3mo ago.

Verified
Source
github-topic:model-context-protocol
Stars
0
Last synced
3mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
10
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (10)

Logs

**WebSocket stream** (deque buffer)

OAuth

**`google-auth-oauthlib`** with PKCE

TLS

none

same

For public exposure I recommend **Cloudflare Tunnel + Cloudflare Access** (zero-config auth in front of the UI) or **Tailscale Funnel** (no public endpoint at all). ## Connecting MCP clients In Claude Desktop / Claude Code / Cursor: *Settings → Developer → Add custom MCP server*. ``` http://localhost:8765/mcp # local http://server.local:8765/mcp # LAN https://gmail-mcp.tailnet.ts.net/mcp # Tailscale https://gmail.your-domain.com/mcp # via tunnel ``` Once connected, Claude has access to the three Gmail tools and you can start prompting: > *"Stiahni mi všetky faktúry z minulého mesiaca do priečinka faktury_2026_04."* > > *"Aké položky a sumy sú na dodacích listoch z dnešného rána?"* > > *"Find the latest contract PDF from any sender at acme.com and summarize the termination clauses."* ## Troubleshooting

Layer

Default (LAN)

none

set `UI_PASSWORD` (HTTP Basic)

Frontend

**Vanilla HTML + CSS + JS**

Container

**multi-arch Docker** (arm64 + amd64)

OCR

**tesseract-ocr (slk+eng)** + **pypdf**

redirect_uri_mismatch

`PUBLIC_URL` in `.env` must exactly match the redirect URI in Google Cloud Console (scheme, host, port, path)