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

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