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: ``bash python server.py ` This 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"]
}
}
}Tools
| Tool | Description | |------|-------------| | get_todays_emails | Get all emails from today | | get_emails | Get emails with optional search query | | get_email | Get full email by ID | | search_emails | Advanced email search | | mark_as_read | Mark emails as read | | send_email | Send an email | | get_labels | List Gmail labels |
Security
Do not commit these files:
credentials.json- OAuth client credentialstoken.json- Your auth token
