1
Add it to Claude Code
claude mcp add -e "GOOGLE_APPLICATION_CREDENTIALS=${GOOGLE_APPLICATION_CREDENTIALS}" gmail-reader -- uv run main.pyRequired:
GOOGLE_APPLICATION_CREDENTIALS2
Make your agent remember this setup
gmail-reader's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Fetch recent emails with pagination
- Create reply drafts
- Create new email drafts
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.Try it
→Fetch my 10 most recent emails.
→Create a new email draft to [email protected] with the subject 'Inquiry' and body 'Hello, I have a question.'
→Reply to the last email I received with the message 'Received, thank you.'
Original README from chronis10/gemini-email-mcp
📧 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
}
}