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 GMAIL_ADDRESS=you@gmail.com \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -- uvx claude-gmail-mcp

Replace you@gmail.com and your-app-password with your actual credentials.

To make it available to only the current project directory:

claude mcp add gmail \
  -e GMAIL_ADDRESS=you@gmail.com \
  -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 alice@example.com 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

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 GMAIL_ADDRESS=you@gmail.com \
  -e GMAIL_APP_PASSWORD=your-app-password \
  -- uv run --directory /path/to/claude-gmail-mcp claude-gmail-mcp