Gmail MCP Server

A lightweight MCP (Model Context Protocol) server that enables sending emails via Gmail. Built for use with Claude Code and other MCP-compatible AI tools.

Features

• Send emails through Gmail using OAuth2 authentication
• Simple MCP tool interface with send_email(to, subject, body)
• Secure token-based auth with automatic refresh

Setup

1. Create a Google Cloud project and enable the Gmail API
2. Download OAuth credentials as credentials.json
3. Install dependencies:

pip install google-auth google-auth-oauthlib google-api-python-client mcp

4. Run the auth flow:

python auth.py

5. Add to your Claude Code MCP config:

{
  "gmail-sender": {
    "type": "stdio",
    "command": "python",
    "args": ["path/to/server.py"]
  }
}

Usage

Once configured, the send_email tool is available in Claude Code:

• to: Recipient email address
• subject: Email subject line
• body: Plain-text email body

Security

OAuth credentials and tokens are excluded via .gitignore. Never commit credentials.json or token.json.