Headless Gmail icon

Headless Gmail

Createdbaryhuang

Enables programmatic Gmail access for sending and receiving emails without local credential or token setup.

About

This tool provides a Model Context Protocol (MCP) server for interacting with Gmail in a headless environment. Unlike traditional Gmail solutions, it allows for remote operation without requiring local file access or browser interaction. Client applications can independently handle OAuth authentication and then pass credentials to the server as context. It is designed for containerization with Docker, offering a decoupled architecture and reliable dependencies on the google-api-python-client library, making it ideal for marketing applications and other scenarios needing focused Gmail functionality.

Key Features

  • Retrieves recent emails with a snippet of the body
  • Automatic refresh token handling
  • Retrieves full email body content in chunks
  • Sends emails through Gmail
  • Refreshes access tokens independently

Use Cases

  • Automating email sending and receiving tasks in headless environments
  • Simplifying Gmail access for marketing automation platforms
  • Integrating Gmail functionality into applications running in Docker containers