gmail-mcp-server

PaulFidika/gmail-mcp-server

3.3

If you are the rightful owner of gmail-mcp-server 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.

An MCP server that allows AI agents to interact with Gmail, enabling email search, style analysis, and draft creation.

The Gmail MCP Server is designed to enhance email management by integrating AI capabilities with Gmail. It allows AI agents to search through Gmail threads, understand the user's email writing style, and create draft emails. The server requires Google authentication and uses OAuth2 credentials to access Gmail data securely. It offers a persistent HTTP mode to avoid repeated OAuth popups, making it user-friendly and efficient. The server focuses on reading and composing emails without sending them, ensuring user control over email dispatch. It also generates a personal email style guide based on the user's sent emails to maintain consistency in communication.

Features

  • Google Authentication: Secure access to Gmail using OAuth2 credentials.
  • Persistent HTTP Mode: Avoids repeated OAuth popups by running as a persistent server.
  • Email Style Guide: Analyzes sent emails to create a personalized writing style guide.
  • Draft Management: Allows creation and updating of email drafts with thread awareness.
  • Attachment Extraction: Safely extracts text from PDF, DOCX, and TXT attachments.

Usages

usage with Cursor

{
  "mcpServers": {
    "gmail": {
      "command": "C:/path/to/your/gmail-mcp-server",
      "env": {
        "GMAIL_CLIENT_ID": "your_client_id_here.apps.googleusercontent.com",
        "GMAIL_CLIENT_SECRET": "your_client_secret_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

usage with Claude Desktop

{
  "mcpServers": {
    "gmail": {
      "command": "C:/path/to/your/auto-gmail.exe",
      "env": {
        "GMAIL_CLIENT_ID": "your_client_id_here.apps.googleusercontent.com",
        "GMAIL_CLIENT_SECRET": "your_client_secret_here",
        "OPENAI_API_KEY": "your_openai_api_key_here"
      }
    }
  }
}

Tools

  1. search_threads

    Search Gmail with queries like 'from:' or 'subject:meeting'.

  2. create_draft

    Create or update email drafts with AI assistance.

  3. extract_attachment_by_filename

    Extract text from attachments using the filename.

  4. get_personal_email_style_guide

    Retrieve the user's email writing style guide.