Gmail MCP Server

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

Remote serverstreamable-httpGo

What is the Gmail 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

The short version

This fork is lean and pragmatic. It's a local stdio MCP server - you run it on your own machine, and your LLM client already has shell + filesystem access. So the threat model is "don't leak credentials to third parties, don't break the Gmail surface" - not "defend a hosted multi-tenant service". I keep dependencies minimal. I use this daily in my own Claude Code workflow - if I wouldn't run it or maintain it myself, it doesn't go in.

  • Send emails with subject, content, attachments, and recipients
  • Full attachment support — - send and receive file attachments
  • Download email attachments — to local filesystem
  • Download full emails — to files in json/eml/txt/html formats
  • Thread-level operations — - get full threads, list inbox threads, batch-expand threads
  • Support for HTML emails and multipart messages with both HTML and plain text versions

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

How to install the Gmail MCP Server

claude mcp add gmail-mcp-server-artymclabin --env GMAIL_OAUTH_PATH=your-value --env GMAIL_CREDENTIALS_PATH=your-value -- npx -y @artymclabin/gmail-mcp

Configuration

VariableDescriptionRequired
GMAIL_OAUTH_PATHFilesystem location the server is allowed to use.Optional
GMAIL_CREDENTIALS_PATHFilesystem location the server is allowed to use.Optional

Frequently asked questions

The source code is linked from the repository URL on this page.