Gmail MCP

Gmail MCP

MCP Gmail service for sending, receiving, and managing emails via Gmail API.

2
Stars
0
Forks
1
Releases

Overview

The MCP Google Email Service implements a Gmail-based email service using the Model Context Protocol. It provides a standardized interface for Gmail integration across applications, reducing boilerplate when interfacing with Gmail API. It supports flexible authentication methods: Service Account via GOOGLE_APPLICATION_CREDENTIALS or GOOGLE_CREDENTIALS_CONFIG, OAuth 2.0 using credentials.json and token.json, and Application Default Credentials. It supports environment-based configuration via environment variables, making it suitable for development, staging, and production. The service leverages MCP to provide consistent context and state management across MCP-compliant services, enabling scalable integration with other MCP components. Core capabilities include sending and receiving emails, listing messages with search capability, replying to messages, and retrieving today's messages. Usage examples demonstrate initializing FastMCP("GMail"), listing unread messages, sending messages, retrieving today's messages, and replying to messages. Requirements include Python 3.11+, google-api-python-client, google-auth-httplib2, google-auth-oauthlib, mcp, pydantic, and python-dotenv. This design supports automated email handling, Gmail functionality integration, logging, and real-time email processing in contexts such as LLM-enabled applications.

Details

Owner
gangradeamitesh
Language
Python
License
Updated
2025-12-07

Features

Email sending and receiving

Send and receive emails through Gmail API.

Message listing with search capabilities

List messages with search queries and optional limits.

Reply to existing messages

Reply to messages by message ID.

Today's message retrieval

Retrieve messages from today with a max_results limit.

Multiple authentication methods support

Support Service Account, OAuth 2.0, and Application Default Credentials.

Environment-based configuration

Configuration via environment variables for flexible deployment.

Audience

ApplicationsAutomates sending and receiving emails within applications.
SystemsIntegrates Gmail functionality into systems needing Gmail access.
ProjectsProvides a standardized way to interact with Gmail in projects.
ServicesMaintains email communication logs for services.
Real-time appsSupports real-time email processing within apps.
LLM appsEnables email context management for language model applications.

Tags

gmailgmail-apimcpmodel-context-protocolemailauthenticationenvironment-variablesgoogle-api-client