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

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

• 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

Required:

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

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

• 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