claude-gmail-mcp

A super tiny Gmail MCP server for Claude Code. Lets Claude send emails on your behalf via Gmail SMTP. I needed something for my projects - there were a bunch around which seemed super complicated. So why not have claude CLI build one for me :-p

Prerequisites

• uv installed
• A Gmail account with a generated App Password

Install

Add the MCP server to Claude Code (this will make it available to all projects):

claude mcp add gmail --scope user \
  -e [email protected] \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -- uvx claude-gmail-mcp

Replace [email protected] and your-app-password with your actual credentials.

To make it available to only the current project directory:

claude mcp add gmail \
  -e [email protected] \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -- uvx claude-gmail-mcp

Verify

claude mcp list

You should see gmail listed as a configured server.

Usage

Once installed, ask Claude to send an email:

Send an email to [email protected] with subject "Hello" and body "Hi from Claude!"

Claude will use the send_email tool, which supports:

• to - recipient address(es)
• subject - email subject
• body - plain text or HTML body
• cc/bcc - optional CC/BCC recipients
• html - set to true to send HTML email
• attachments - list of local file paths to attach (files that can't be read are skipped with a warning)

Example with an attachment:

Send an email to [email protected] with subject "Report" and attach ~/Documents/report.pdf

Publishing to PyPI

python -m build && twine upload dist/*

For Development

git clone https://github.com/pliablepixels/claude-gmail-mcp.git
cd claude-gmail-mcp
uv sync

Run the server locally:

uv run claude-gmail-mcp

To test with Claude Code using your local copy instead of the published package:

claude mcp add gmail \
  -e [email protected] \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -- uv run --directory /path/to/claude-gmail-mcp claude-gmail-mcp