📧 Gmail MCP Server using FastMCP

A Model Context Protocol (MCP) server built with FastMCP that integrates with the Gmail API. This project demonstrates how to create AI-accessible tools for reading and sending emails using Google OAuth authentication.

🚀 Features

• 🔐 Google OAuth 2.0 authentication
• 📩 Send emails through Gmail
• 📥 Read Gmail messages
• 🛠️ MCP tools using FastMCP
• ⚡ Lightweight Python implementation
• 🔒 Secure credential management using environment variables

🛠️ Tech Stack

• Python 3.13
• FastMCP
• Gmail API
• Google OAuth 2.0
• Uvicorn
• python-dotenv

📂 Project Structure

.
├── main.py
├── oauth.py
├── tools/
│   ├── gmail.py
│   └── __init__.py
├── .env
├── requirements.txt
└── README.md

⚙️ Installation

1. Clone the repository

git clone https://github.com/your-username/mcp-practice.git
cd mcp-practice

2. Create a virtual environment

python -m venv .venv

3. Activate the environment

Windows

.venv\Scripts\activate

Linux/macOS

source .venv/bin/activate

4. Install dependencies

pip install -r requirements.txt

🔑 Configure Environment Variables

Create a .env file and add:

GOOGLE_CLIENT_SECRET_PATH=client_secret.json
GOOGLE_TOKEN_PATH=token.json

▶️ Authenticate Gmail

python oauth.py

This will open a browser for Google authentication and generate token.json.

▶️ Run the MCP Server

python main.py

or

uv run fastmcp dev main.py:mcp

📚 Learning Objectives

This project was created to practice:

• Model Context Protocol (MCP)
• FastMCP framework
• Tool decorators
• Prompt decorators
• Google OAuth
• Gmail API integration
• AI tool development

📌 Future Improvements

• Email search
• Delete emails
• Mark emails as read/unread
• Attachment support
• Async MCP tools
• Better error handling

🤝 Contributing

Contributions and suggestions are welcome.

📄 License

This project is for educational and learning purposes.