gmail-mcp-server

Let your AI assistant manage your Gmail — search, read, send, label, archive, and more through natural conversation.

Works with Claude Code, Claude Desktop, Cursor, Windsurf, and any MCP-compatible app.

<p align="center"> </p>

---

git clone https://github.com/saidulalam01/gmail-mcp-server.git
cd gmail-mcp-server
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\activate
pip install -r requirements.txt

> No git? Click the green Code button on GitHub → Download ZIP.

1. Go to console.cloud.google.com and create a project
2. Go to APIs & Services → Library → search Gmail API → Enable
3. Go to APIs & Services → OAuth consent screen → choose External → fill in app name and your email → Save and Continue
4. On the Scopes page, add these three then save:

   https://www.googleapis.com/auth/gmail.modify
   https://www.googleapis.com/auth/gmail.compose
   https://www.googleapis.com/auth/gmail.labels

1. On the Test users page, add your Gmail address → save
2. Go to APIs & Services → Credentials → + Create Credentials → OAuth client ID → type: Desktop app → Create
3. Download the JSON file and move it into the project folder

python gmail_mcp_server.py --auth

Your browser opens for Google sign-in. If you see "This app isn't verified", click Advanced → Go to Gmail MCP Server (unsafe) — this is normal for personal projects.

Get your