$","meta","1",{"name":"viewport","content":"width=device-width, initial-scale=1"}]] b:null 28:I[60719,["7626","static/chunks/f6ab4fea-4425dae3da7674a3.js","8548","static/chunks/b27dc69b-e5acb70cd9d66ddf.js","5232","static/chunks/5232-db5923cda78a4960.js","6465","static/chunks/6465-6b79f1dc957ae3f4.js","9388","static/chunks/9388-d1a745fd53a10850.js","4902","static/chunks/4902-40271c136eb736f1.js","1508","static/chunks/1508-abbc58115cbb4fd0.js","6125","static/chunks/6125-6f7cbc86df4f2503.js","7771","static/chunks/7771-66979ce602088329.js","7660","static/chunks/7660-f5d56ac6a9ee6cc8.js","4147","static/chunks/4147-ef3df161a800b88b.js","9783","static/chunks/9783-e1d5b54e9718b38b.js","8084","static/chunks/8084-f1229cc5d0501fe0.js","2024","static/chunks/2024-e03e13f5faa34f45.js","7796","static/chunks/app/%5Blocale%5D/(default)/server/%5Bname%5D/%5Bauthor_name%5D/page-c3a3facf548ee943.js"],"default"] 29:T1684,# Gmail MCP

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

--- ## 📋 English Documentation Pull requests to this repository are welcome. ### 📖 Table of Contents - [Overview](#overview) - [Features](#features) - [Prerequisites](#prerequisites) - [Setup](#setup) - [Usage](#usage) - [License](#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, and managing Gmail labels. ### ✨ Features - ✉️ Send emails and create drafts - 📬 Read and search emails - 🗑️ Delete emails - 🏷️ Manage Gmail labels (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](https://github.com/astral-sh/uv) - Python package installer ### 🚀 Setup 1. Clone this repository ```bash git clone https://github.com/ykuchiki/gmail-mcp.git cd gmail-mcp ``` 2. Create and activate a virtual environment ```bash uv init ``` 3. Install dependencies ```bash 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](https://console.cloud.google.com/) - Enable the Gmail API - Create OAuth credentials - 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. ```json { "mcpServers": { "gmail-mcp": { "command": "uv", "args": [ "--directory", "/path/to/your/gmail-mcp/src", "run", "main.py" ] } } } ``` 6. Run the server ```bash uv run main.py ``` ### 💡 Usage The server can be used with any MCP-compatible client. On first run, it will prompt you to authenticate with your Gmail account. ### 📄 License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. --- ## 📋 日本語ドキュメント本リポジトリはpullリクエスト大歓迎です。 ### 📖 目次 - [概要](#概要) - [機能](#機能) - [前提条件](#前提条件)

Gmail MCP

Comments