Gmail API for AI Assistants using Model Context Protocol 한국어 | 日本語

---

한국어 문서

이 저장소에 대한 풀 요청은 환영합니다.

제목의 표

• 개요
• 특징
• 필수
• 설치
• 사용
• 라이센스

## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ## ##

Gmail MCP는 MCP(모델 Context Protocol)을 통해 Gmail과 상호작용할 수 있는 서버 구현입니다. Gmail 라벨 관리 및 필터 관리, 인박스를 통해 검색, 이메일 관리, 초안 관리, 이메일 관리, 이메일 관리에 대한 도구를 제공합니다.

✨ 특징

• ✉️ 이메일 보내기 및 초안 만들기
• 읽기 및 검색 이메일
• ️ 메일 삭제
• ️ Gmail 라벨 관리 (create, update, delete)
• ️ Gmail 필터 관리 (create, update, delete)
• Gmail API로 OAuth2.0 인증

Pre Pre Pre

• Python 3.11 이상
• Gmail 계정
• Gmail API를 사용한 Google Cloud Platform 프로젝트
• uv - 파이썬 패키지 설치 프로그램

##🚀 🚀

1. Clone 이 저장소

2. 가상 환경을 만들고 활성화

3. 의존성 설치

4. OAuth 자격 설정

• 프로젝트의 루트에서 credentials라는 디렉토리를 만듭니다

Gmail MCP

Gmail API for AI assistants using Model Context Protocol English | Español | 日本語

---

📋 English Documentation

Pull requests to this repository are welcome.

📖 Table of Contents

• Overview
• Features
• Prerequisites
• Setup
• Usage
• License

🔍 Overview

Gmail MCP is a server implementation that enables AI assistants to interact with Gmail through the MCP (Model Context Protocol). It provides tools for sending emails, managing drafts, reading emails, searching through your inbox, managing Gmail labels and manageing filters.

✨ Features

• ✉️ Send emails and create drafts
• 📬 Read and search emails
• 🗑️ Delete emails
• 🏷️ Manage Gmail labels (create, update, delete)
• 🗂️ Manage Gmail filters (create, update, delete)
• 🔐 OAuth2.0 authentication with Gmail API

📋 Prerequisites

• Python 3.11 or higher
• Gmail account
• Google Cloud Platform project with Gmail API enabled
• uv - Python package installer

🚀 Setup

1. Clone this repository

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

2. Create and activate a virtual environment

uv init

3. Install dependencies

uv pip install -r requirements.txt

4. Set up OAuth credentials

   • Create a directory named credentials in the root of the project
   • Create a project in Google Cloud Console
   • Enable the Gmail API
   • Create OAuth credentials
   • Add the following URI to the Authorized redirect URIs:

     http://localhost:8080/
     

   • Download the credentials JSON file and save it as credentials/client_secret_gmail_oauth.json

5. Add MCP server Please refer to your MCP client’s official documentation for specific instructions. Make sure to adjust the path according to your environment.

{
    "mcpServers": {
        "gmail-mcp": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/your/gmail-mcp/src",
                "run",
                "main.py"
            ]
        }
    }
}

6. Run the server

uv run main.py