gmail-mcp-aider

ajaysmb/gmail-mcp-aider

3.2

If you are the rightful owner of gmail-mcp-aider and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Gmail MCP Server provides seamless integration of Gmail functionalities into Claude Desktop, enabling users to manage their emails efficiently.

Gmail MCP Server

A Model Context Protocol (MCP) server that provides Gmail integration for Claude Desktop.

Features

  • List Gmail messages with optional search queries (up to 500 messages)
  • Get full message details by ID
  • Bulk process multiple messages with metadata extraction
  • List and download email attachments
  • Send emails (with confirmation)
  • Search emails using Gmail search operators (via search_emails)

Setup

  1. Install the package:
pip install -e .

  1. Set up Google OAuth:

    • Go to Google Cloud Console
    • Create a new project or select existing
    • Enable Gmail API
    • Create OAuth 2.0 credentials
    • Download as client_secret.json in this directory
    • Add http://localhost:8080/ as authorized redirect URI

  2. Configure Claude Desktop by adding to your config file:

{
  "mcpServers": {
    "gmail": {
      "command": "gmail-mcp",
      "args": []
    }
  }
}

Testing

Run in test mode to verify Gmail connection:

gmail-mcp test