jeffreyyoung

jeffreyyoung

MCP_Proxy

Public

Val Town is a collaborative website to build and scale JavaScript apps.

Deploy APIs, crons, & store data – all from the browser, and deployed in milliseconds.

/

MCP Gmail Proxy

An MCP (Model Context Protocol) proxy server that provides authenticated Gmail access through OAuth.

Features

OAuth 2.0 authentication with Google
MCP server implementation for Gmail operations
Session management and token refresh
Secure proxy for Gmail API access

Architecture

backend/index.ts - Main HTTP server and MCP endpoint
backend/auth/ - OAuth flow and session management
backend/mcp/ - MCP protocol implementation
backend/gmail/ - Gmail API integration
frontend/ - OAuth callback and admin interface

Environment Variables

Required:

GOOGLE_CLIENT_ID - Google OAuth client ID
GOOGLE_CLIENT_SECRET - Google OAuth client secret
JWT_SECRET - Secret for signing session tokens

Usage

Start OAuth flow: GET /auth/google
Handle callback: GET /auth/callback
Connect MCP client to: POST /mcp (with Authorization header)

MCP Tools

gmail_list_messages - List Gmail messages
gmail_get_message - Get specific message content
gmail_send_message - Send email
gmail_search_messages - Search messages with query