Gmail Assistant

Provides an MCP server that fetches Gmail messages and drafts replies using Claude, with optional Google Docs guidelines.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "thejoefriel-gmail-assistant-mcp": {
      "command": "/path/to/gmail-assistant-mcp/venv/bin/python",
      "args": [
        "/path/to/gmail-assistant-mcp/src/gmail_assistant/server.py"
      ],
      "env": {
        "EMAIL_USER": "your.email@gmail.com",
        "ANTHROPIC_API_KEY": "your-anthropic-api-key",
        "GUIDELINES_DOC_ID": "your-google-doc-id-optional",
        "EMAIL_APP_PASSWORD": "your-app-password"
      }
    }
  }
}

You run a Gmail Assistant MCP server that integrates with Gmail to fetch unread messages and generate draft replies using Claude, with optional guidelines from a Google Doc. This MCP lets you automate email workflows while keeping control over credentials and API keys in a single managed config.

How to use

You start the Gmail Assistant MCP server through your MCP client. The server exposes a stdio interface, so you run the Python interpreter inside your virtual environment and execute the Gmail assistant script. Once running, you can command Claude to fetch unread emails, draft replies for emails sent to you, and optionally consult your guidelines document to align writing style and context.

How to install

Prerequisites you need before installation:

Python 3.10 or newer

Set up a Gmail account with an App Password for authentication.

Obtain an Anthropic API key for Claude access.

(Optional) Set up a Google Cloud project and enable the Docs API if you want to reference writing guidelines.

Step-by-step commands to prepare and run the MCP server:

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies (as needed for your project)
pip install -r requirements.txt

# Ensure you have set up Gmail App Password and Google Docs guidelines if used

Additional sections

Configuration details are provided below. You will pass credentials and API keys via environment variables in your MCP config. The following settings are the exact keys shown for the server configuration in your Claude Desktop integration.

Available tools

fetch_emails

Fetch unread Gmail messages for processing by Claude.

draft_replies

Draft replies to selected emails where you are the recipient.

fetch_last10_and_draft

Fetch the last 10 emails and generate drafts for messages addressed to you.

Built by

VeilStrat

AI signals for GTM teams