README.md
Manage Gmail using a FastMCP API server for Gemini-CLI.
📧 FastMCP Gmail Reader Server
Manage Gmail using a FastMCP API server for Gemini-CLI. Supports reading emails and creating drafts (reply or new).
🚀 Features
- Fetch recent emails with pagination
- Create reply drafts
- Create new email drafts
🔧 Setup
Install Dependencies
pip install uv
cd gemini-tasks-mcp
uv venv
source .venv/bin/activate
uv run main.py
Generate Google API Credentials
- Go to Google Cloud Console.
- Create a project and enable Gmail API.
- Go to APIs & Services → Credentials.
- Click “Create Credentials” → “OAuth client ID” → Application type: Desktop App.
- Download
credentials.jsonand place it in the project folder.
Gemini-CLI Configuration
cd ~/.gemini
nano settings.json
"mcpServers": {
"gmailReader": {
"command": "uv",
"args": ["run", "main.py"],
"cwd": "<<full-path>>/gemini-email-mcp",
"timeout": 20000
}
}
Tools (2)
fetch_emailsFetch recent emails from Gmail with pagination support.create_draftCreate a new email draft or a reply draft.Environment Variables
GOOGLE_APPLICATION_CREDENTIALSrequiredPath to the credentials.json file downloaded from Google Cloud Console.Configuration
claude_desktop_config.json
{
"mcpServers": {
"gmailReader": {
"command": "uv",
"args": ["run", "main.py"],
"cwd": "<<full-path>>/gemini-email-mcp",
"timeout": 20000
}
}
}Try it
→Fetch my 10 most recent emails.
→Create a new email draft to support@example.com with the subject 'Inquiry' and body 'Hello, I have a question.'
→Reply to the last email I received with the message 'Received, thank you.'