Skip to main content
Glama
Gmail MCP Assistant

Gmail MCP Assistant

by sat899

Gmail MCP Assistant

A Model Context Protocol (MCP) server that enables Anthropic's Claude to read unread emails and create draft responses using the Gmail API.

Prerequisites

  • Python 3.10+

  • uv (Python package manager)

  • Claude Desktop app installed

  • A Google Cloud Project with the Gmail API enabled

Related MCP server: Gmail MCP Local Server

Setup

1. Google Cloud Configuration

  1. Go to the Google Cloud Console and create a new project

  2. Enable the Gmail API

  3. Configure the OAuth Consent Screen and add your email as a Test User

  4. Create OAuth 2.0 Credentials for a Desktop Application

  5. Download the JSON file, rename it to client_secret.json, and place it in this project's root directory

2. Installation

# Install dependencies
uv sync

3. Authentication

On first run, Claude Desktop will start the server and open a browser window for OAuth authentication. After authorizing, a token.json file will be created for future use.

4. Claude Desktop Configuration

Add this server to your Claude Desktop MCP configuration file. Edit claude_desktop_config.json and add:

{
  "mcpServers": {
    "gmail-assistant": {
      "command": "C:\\Users\\Satyam\\.local\\bin\\uv.exe", 
      "args": [
        "--directory",
        "C:\\Users\\Satyam\\Downloads\\mlx_application",
        "run",
        "server.py"
      ]
    }
  }
}

Update the paths to match your system:

  • command: Path to your uv.exe executable (you can get this by running uv where)

  • --directory: Path to this project directory

After saving the configuration, restart Claude Desktop to load the server.

Usage

Once configured, you can use the tools in Claude Desktop. Simply start a chat and ask something like 'What emails do I need to respond to?'. Claude will use the following tools:

  • get_unread_emails: Retrieve unread emails from your inbox

  • create_draft_reply: Create a draft reply for a specific email thread

Available Tools

2 tools
create_draft_replyC

Creates a draft reply for a specific thread.

Inputs: thread_id (required), reply_text (required).

get_unread_emailsC

Fetches a list of unread emails from the user's inbox.

Inputs: max_results.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.1/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one retrieves unread emails, the other creates a draft reply. There is no overlap or ambiguity between them.

    Naming Consistency5/5

    Both tool names follow a consistent verb_noun pattern in snake_case (get_unread_emails, create_draft_reply). The naming is predictable and readable.

    Tool Count3/5

    With only two tools, the set is quite thin for a Gmail assistant, which typically involves many operations. It is borderline but not an extreme mismatch.

    Completeness2/5

    Major gaps exist: no tools for sending emails, reading individual message content, searching, marking as read, or deleting. An agent cannot complete common email workflows with these two tools alone.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables reading, sending, searching, and managing Gmail through Claude using the official Google Gmail API.
      98 npm
      3
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables Claude to read unread emails and create draft replies in Gmail with proper threading.
      -