Enables fetching and summarizing emails from Gmail based on custom queries or recent activity, including retrieving email summaries and finding top matching emails based on keywords.
Uses Google Cloud's OAuth authentication system and Gmail API to securely access and interact with user's email data.
๐ฌ EmailAssistant for Claude Desktop
EmailAssistant is an MCP-compatible server that integrates with the Gmail API to fetch and summarize emails based on custom queries or recent activity. It can be used with Claude Desktop to interact hands-free with your inbox.
โ๏ธ Setup Instructions
1. Enable Gmail API
Go to Google Cloud Console.
Create a new project or use an existing one.
Enable the Gmail API under โAPIs & Servicesโ.
Create OAuth 2.0 Client ID credentials.
Download the
client_secret_XXXXX.jsonfile.
Related MCP server: Gmail MCP Server
๐ง Configuration Summary
๐ Create config.py with these contents:
Note: Make sure to replace the placeholders in the above code---PROJECT_DIR & CREDENTIALS_FP
๐ฅ๏ธ 3. Claude Desktop Configuration
In your Claude Desktop configuration file (can find it in Developer Settings):
โ Running It
Once configured:
Start Claude Desktop
Claude will automatically recognize the
EmailAssistantMCP server.You can now use Claude to call functions like:
All you need to do is ask Claude in plain english about your inbox
๐ Requirements
Python 3.9+
uv(or usepipif not usinguv)The following Python packages:
google-api-python-clientgoogle-auth-httplib2google-auth-oauthlibmcp[cli]