📧 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.