gmail-mcp
Provides tools for reading, sending, and managing Gmail emails, including searching, marking as read, and retrieving labels.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Gmail MCP Server
MCP server for Gmail integration with Claude Code.
Setup
1. Create Google Cloud Credentials
Go to Google Cloud Console
Create a new project (or select existing)
Enable the Gmail API
Go to Credentials → Create Credentials → OAuth 2.0 Client ID
Application type: Desktop app
Download the JSON file
Rename to
credentials.jsonand place in this folder
2. Install Dependencies
cd D:\Projects\gmail-mcp
pip install -r requirements.txt3. First-time Authentication
Run once to authorize:
python server.pyThis will open a browser for OAuth consent. After authorizing, a token.json file is created.
4. Add to Claude Code
Add to your MCP settings (%APPDATA%\Claude\claude_desktop_config.json or VS Code settings):
{
"mcpServers": {
"gmail": {
"command": "python",
"args": ["D:\\Projects\\gmail-mcp\\server.py"]
}
}
}Related MCP server: Gmail MCP Server
Tools
Tool | Description |
| Get all emails from today |
| Get emails with optional search query |
| Get full email by ID |
| Advanced email search |
| Mark emails as read |
| Send an email |
| List Gmail labels |
Security
Do not commit these files:
credentials.json- OAuth client credentialstoken.json- Your auth token
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Your mailboxes in ChatGPT and Claude: Gmail, iCloud, Fastmail, any IMAP. Passwords stay yours.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables reading, sending, searching, and managing Gmail through Claude using the official Google Gmail API.3MIT
- FlicenseAqualityDmaintenanceEnables Claude to read, search, send, and manage Gmail messages and threads through natural language.13-
- FlicenseNot gradedqualityDmaintenanceEnables Claude to read and manage your Gmail account, including listing, searching, sending, drafting, replying to, archiving, labeling, and trashing emails via the Gmail API.-
- AlicenseNot gradedqualityDmaintenanceConnects Claude Code to Gmail for reading, searching, drafting, and managing emails with features like labels, filters, and smart workflows.MIT