📧 MCP Gmail Proxy

Secure Gmail access through Model Context Protocol

\n\n

🔐 Authentication

Checking authentication status...

\n \n 🔑 Sign in with Google\n \n

\n\n

🔧 MCP Connection

\n After authentication, use this endpoint for your MCP client:\n

\n POST https://your-domain.web.val.run/mcp\n

\n Include your session token in the Authorization header:\n

\n Authorization: Bearer YOUR_SESSION_TOKEN\n

\n\n

📋 Available Tools

gmail_list_messages

List Gmail messages with optional query and pagination

\n Parameters: query (optional), maxResults (optional), pageToken (optional)\n

\n \n

gmail_get_message

Get a specific Gmail message by ID

\n Parameters: messageId (required)\n

\n \n

gmail_send_message

Send an email via Gmail

\n Parameters: to (required), subject (required), body (required), cc (optional), bcc (optional)\n

\n \n

gmail_search_messages

Search Gmail messages with advanced query

\n Parameters: query (required), includeSpamTrash (optional)\n

\n\n

📖 Usage Examples

List recent messages:

{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 1,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"gmail_list_messages\",\n    \"arguments\": {\n      \"maxResults\": 5\n    }\n  }\n}

\n \n

Search for unread messages:

{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 2,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"gmail_search_messages\",\n    \"arguments\": {\n      \"query\": \"is:unread\"\n    }\n  }\n}

\n \n

Send an email:

{\n  \"jsonrpc\": \"2.0\",\n  \"id\": 3,\n  \"method\": \"tools/call\",\n  \"params\": {\n    \"name\": \"gmail_send_message\",\n    \"arguments\": {\n      \"to\": \"recipient@example.com\",\n      \"subject\": \"Hello from MCP\",\n      \"body\": \"This email was sent via the MCP Gmail proxy!\"\n    }\n  }\n}

\n\n \n\n","deleted","label",[169,153],"frontend","permalink","https://www.val.town/x/jeffreyyoung/MCP_Proxy/code/frontend/index.html","extension","html","actionData","errors"]