MCP Gmail Server
A minimal Model Context Protocol (MCP) server that sends emails through Gmail.
Quick Start
-
Install dependencies:
npm install -
Set up Gmail credentials:
cp .env.example .env # Edit .env with your Gmail credentials -
Build and run:
npm run build npm start
Configuration
Set these environment variables in .env:
GMAIL_USER: Your Gmail addressGMAIL_PASS: Gmail App Password (not your regular password)
Usage
The server exposes one tool: send_email
Parameters:
to: Recipient email addresssubject: Email subject linebody: Email content (plain text)
Files
src/index.ts- Main MCP server implementation.well-known/mcp.json- MCP server manifest.vscode/mcp.json- VS Code MCP configuration
Testing
# Test with MCP Inspector
npx @modelcontextprotocol/inspector node build/index.js
## How It Works
1. Creates MCP server with Gmail transporter
2. Registers `send_email` tool with input validation
3. Connects via STDIO transport for MCP communication
4. Returns structured responses with success/error states