MCP Email Summarizer

Table of Contents

1. Features
2. Built With
3. Contributing
4. Contact

Features

• Email Access: Fetch emails from specific senders or time periods
• Smart Summaries: Ask Claude to summarize email content in various ways

Built With

• Python 3.11 - Core language
• MCP - Model Context Protocol for AI tool integration
• Google Gmail API - Email access
• Claude Desktop - AI assistant with MCP support

(back to top)

Getting Started

Prerequisites

• Python 3.10 or higher
• Claude Desktop
• Google account with Gmail

Installation

Clone the repository:

clone https://github.com/asakohayase/mcp-email-summarizer
cd mcp-email-summarizer

Create a virtual environment using uv:

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

Install dependencies:

uv install

Set Up Gmail API Access

Enable Gmail API:

• Go to Google Cloud Console.
• Create a new project (e.g., "MCP Email Summarizer").
• Navigate to "APIs & Services" > "Library," search for "Gmail API," and enable it.

Create OAuth Credentials:

• Go to "APIs & Services" > "Credentials."
• Click "CONFIGURE CONSENT SCREEN"
• Select "External" in User Type
• Fill in App Information and add your email address
• Go to "Scopes" and add "https://www.googleapis.com/auth/gmail.readonly"
• Go to "Test users" and add your email address
• Go to "Credentials" and create an OAuth client ID (Desktop application)
• Download the credentials JSON file and save it as credentials.json in your project folder

Authenticate with Gmail:

• Create and run the following script to generate your authentication token:

from google_auth_oauthlib.flow import InstalledAppFlow
SCOPES = ['https://www.googleapis.com/auth/gmail.readonly']
flow = InstalledAppFlow.from_client_secrets_file('credentials.json', SCOPES)
creds = flow.run_local_server(port=0)
with open('token.json', 'w') as token:
    token.write(creds.to_json())

• Run it:

uv credentials.py

Configure Claude Desktop

Create or edit the Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add your MCP server configuration:

{
    "mcpServers": {
        "mcp_email_summarizer": {
            "command": "/Users/username/.local/bin/uv",
            "args": [
                "--directory",
                "/Users/username/mcp_email_summarizer",
                "run",
                "mcp_email_server.py"
            ]
        }
    }
}

You need to:

Replace /Users/username/.local/bin/uv with the full path to your uv executable (find using which uv on macOS/Linux or where uv on Windows). Replace /Users/username/projects/mcp_email_summarizer with the absolute path to your project directory.

Usage

Open Claude Desktop Ask questions like:

"Summarize my emails from newsletter@example.com in the past week"

"What are the main topics in my emails from the last month?"

"Find action items in my recent emails"

"Analyze the sentiment of emails from my team"

Claude will:

Request permission to access your emails Execute the appropriate MCP tools Present the analyzed information in a conversational format

Contributing

If you have an idea to improve this, kindly fork the repository and open a pull request. We also welcome enhancement suggestions filed as issues. Stars ⭐ from you will brighten our day! Thanks for checking out our project.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/NewFeature)
3. Commit your Changes (git commit -m 'Add some NewFeature')
4. Push to the Branch (git push origin feature/NewFeature)
5. Open a Pull Request

Contact

Asako Hayase- LinkedIn