Happy slice of mcp pizzaMCP.pizza

Gmail-MCP-Server

MCP.Pizza Chef: GongRzhe

Once it is connected, Claude Desktop can search your mail by sender, subject, or date, read a thread, draft and send a reply with attachments, download files people sent you, and tidy things up with labels. It works on batches too, so a hundred newsletters can be archived in one go. Setup is the fussy part: you create Google sign-in credentials of your own and approve access in the browser once.

Archived · The author made this repository read-only on GitHub.
Email
Files/PDF

Use This MCP server To

Find every email from my landlord in the last six months Draft a reply to this thread and attach the signed contract Archive all newsletters from last month in one batch Label everything from my accountant as Taxes 2026 Save the attachments from this invoice email to my computer Mark the unread messages from my team as read

README

Gmail AutoAuth MCP Server

A Model Context Protocol (MCP) server for Gmail integration in Claude Desktop with auto authentication support. This server enables AI assistants to manage Gmail through natural language interactions.

smithery badge

Features

  • Send emails with subject, content, attachments, and recipients
  • Full attachment support - send and receive file attachments
  • Download email attachments to local filesystem
  • Support for HTML emails and multipart messages with both HTML and plain text versions
  • Full support for international characters in subject lines and email content
  • Read email messages by ID with advanced MIME structure handling
  • Enhanced attachment display showing filenames, types, sizes, and download IDs
  • Search emails with various criteria (subject, sender, date range)
  • Comprehensive label management with ability to create, update, delete and list labels
  • List all available Gmail labels (system and user-defined)
  • List emails in inbox, sent, or custom labels
  • Mark emails as read/unread
  • Move emails to different labels/folders
  • Delete emails
  • Batch operations for efficiently processing multiple emails at once
  • Full integration with Gmail API
  • Simple OAuth2 authentication flow with auto browser launch
  • Support for both Desktop and Web application credentials
  • Global credential storage for convenience

Installation & Authentication

Installing via Smithery

To install Gmail AutoAuth for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @gongrzhe/server-gmail-autoauth-mcp --client claude

Installing Manually

Gmail-MCP-Server FAQ

Which apps does this work in?
It is set up for Claude Desktop, and it works in any other app where you can add an MCP server yourself.
Do I need a key from Google?
Yes. You create your own Google sign-in credentials, save the file, then approve access once in your browser.
Can I use this to send an email with a file attached?
Yes, you can point it at files on your computer and it will attach them to the message it sends.
How hard is the setup?
The Google credential step takes about fifteen minutes the first time. After that you paste one small block into your app's settings.
Can it delete or move my mail?
Yes. It can delete messages, move them between labels, and mark them read or unread, so read back what you asked for before confirming.
Does it work with a work Google Workspace account?
It works with any Gmail account you can create sign-in credentials for, including Workspace, as long as your administrator allows it.
Where does my mail go?
The tool runs on your own machine and talks directly to Google, so your messages do not pass through a third-party service.