Gmail MCP Server

A Model Context Protocol (MCP) server for Gmail & Google Calendar integration with Claude Desktop, enabling intelligent, context-aware interactions with your email.

🌟 Features

• Deep Email Analysis: Provides comprehensive context from entire conversation threads
• Context-Aware Responses: Generates responses considering full communication history
• Intelligent Action Suggestions: Analyzes email content for calendar events, tasks, and follow-ups
• Calendar Integration: Detects events in emails and creates calendar entries with natural language support
• Advanced Search: Searches across entire email history with semantic understanding
• Personalization: Adapts to your communication style with specific contacts

🚀 Getting Started

Prerequisites

• Python 3.10+
• A Google Cloud Platform account with Gmail API and Google Calendar API (optional) enabled
• OAuth 2.0 credentials for the Gmail API and Google Calendar API (optional)
• Claude Desktop with MCP support (currently only LLM interface to support MCP)

Installation

Installing via Smithery

To install Gmail Integration Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @bastienchabal/gmail-mcp --client claude

Installing Manually

1. Clone this repository:

   git clone https://github.com/bastienchabal/gmail-mcp.git
   cd gmail-mcp
   

2. Set up a virtual environment using uv:

   pip install uv
   uv venv
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

3. Install dependencies:

   uv pip install -e .
   

⚙️ Configuration

Step 1: Authenticate with Google

1. Go to the Google Cloud Console
2. Create a new project or select an existing one
3. Enable Google APIs:
   • Enable the Gmail API
   • Enable the Calendar API
4. Configure the OAuth consent screen:
   • Select “External” user type
   • Add your email as a test user
   • Add all the scopes of Gmail and Calendar
5. Create OAuth 2.0 credentials:
   • Choose “Desktop app” as the application type
   • Download the JSON credentials file and copy the Client ID and Client Secret

Step 2: Configure Claude Desktop

1. Create or edit the claude_desktop_config.json file in /Users//Library/Application Support/Claude
2. Add the following configuration, replacing the placeholders with your actual values:

{
  "mcpServers": {