Gmail MCP Server

Example Use Cases

• 1

  Read and index recent inbox emails to provide context-aware responses or summaries.

• 2

  Search a user's mailbox using Gmail search syntax to find relevant messages or attachments.

• 3

  Fetch specific email content and metadata (by ID) or enumerate labels for routing and automation tasks.

Description

This project implements a Gmail Model Context Protocol (MCP) server that lets agents interact programmatically with a Gmail account. It provides tools to list inbox messages, fetch specific emails, run Gmail search queries, and retrieve labels after authenticating via OAuth. The server is built with Bun and is intended for local deployment; credentials and OAuth keys are stored on the user's machine. It enables agents to access and manipulate Gmail data in workflows that require email context.