Gmail MCP Server

What is Gmail MCP Server?

Gmail MCP Server is a Python-based server that integrates Gmail and Google Calendar with Claude Desktop via the Message Control Protocol (MCP). It allows users to manage emails and schedule calendar events using natural language commands, automating tasks like email summarization, sending, and event creation.

How to use Gmail MCP Server?

Install the package with pip install gmail-mcp-server, then place your Google Cloud OAuth 2.0 credentials file (credentials.json) in the ~/.gmail_mcp_server/ directory. Configure Claude Desktop to connect to the server; the server handles authentication and API calls automatically.

Key features of Gmail MCP Server

• Summarize up to 5 recent emails, filtered by sender or label.
• Send emails with CC and BCC support from Claude Desktop.
• Manually create Google Calendar events from email content.
• Automatically create calendar events for important emails every 10 minutes.
• Secure OAuth 2.0 authentication via Google Cloud credentials.
• Lightweight, cross-platform server (Windows, macOS, Linux).

Use cases of Gmail MCP Server

• Summarize your inbox to quickly catch up on important messages.
• Send professional emails directly through a chat interface.
• Turn flagged emails into calendar events without manual entry.
• Automatically schedule meetings from emails marked as important.

FAQ from Gmail MCP Server

What is Gmail MCP Server?

Gmail MCP Server is a background server that connects Gmail and Google Calendar to Claude Desktop via MCP, enabling natural language email and calendar management.

What prerequisites are needed?

You need Python 3.8+, Claude Desktop, a Google Cloud Project with Gmail and Calendar APIs enabled, a Gmail account, and basic command-line familiarity.

How does authentication work?

The server uses OAuth 2.0 by reading a credentials.json file from ~/.gmail_mcp_server/ to securely access Google APIs.

What platforms are supported?

It works on Windows, macOS, and Linux; the credentials file goes in the user's home directory under .gmail_mcp_server/.

How often does automatic calendar event creation run?

The server monitors your inbox every 10 minutes to create calendar events for new emails labeled "important".