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 address
GMAIL_PASS: Gmail App Password (not your regular password)

Usage

The server exposes one tool: send_email

Parameters:

to: Recipient email address
subject: Email subject line
body: 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