Gmail MCP Assistant
Allows reading unread emails from Gmail inbox and creating draft replies via the Gmail API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Gmail MCP Assistant What are my unread emails?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Gmail MCP Assistant
A Model Context Protocol (MCP) server that enables Anthropic's Claude to read unread emails and create draft responses using the Gmail API.
Prerequisites
Python 3.10+
uv (Python package manager)
Claude Desktop app installed
A Google Cloud Project with the Gmail API enabled
Related MCP server: Gmail MCP Local Server
Setup
1. Google Cloud Configuration
Go to the Google Cloud Console and create a new project
Enable the Gmail API
Configure the OAuth Consent Screen and add your email as a Test User
Create OAuth 2.0 Credentials for a Desktop Application
Download the JSON file, rename it to
client_secret.json, and place it in this project's root directory
2. Installation
# Install dependencies
uv sync3. Authentication
On first run, Claude Desktop will start the server and open a browser window for OAuth authentication. After authorizing, a token.json file will be created for future use.
4. Claude Desktop Configuration
Add this server to your Claude Desktop MCP configuration file. Edit claude_desktop_config.json and add:
{
"mcpServers": {
"gmail-assistant": {
"command": "C:\\Users\\Satyam\\.local\\bin\\uv.exe",
"args": [
"--directory",
"C:\\Users\\Satyam\\Downloads\\mlx_application",
"run",
"server.py"
]
}
}
}Update the paths to match your system:
command: Path to youruv.exeexecutable (you can get this by runninguv where)--directory: Path to this project directory
After saving the configuration, restart Claude Desktop to load the server.
Usage
Once configured, you can use the tools in Claude Desktop. Simply start a chat and ask something like 'What emails do I need to respond to?'. Claude will use the following tools:
get_unread_emails: Retrieve unread emails from your inboxcreate_draft_reply: Create a draft reply for a specific email thread
Available Tools
2 toolscreate_draft_replyC
Creates a draft reply for a specific thread.
Inputs: thread_id (required), reply_text (required).
get_unread_emailsC
Fetches a list of unread emails from the user's inbox.
Inputs: max_results.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have clearly distinct purposes: one retrieves unread emails, the other creates a draft reply. There is no overlap or ambiguity between them.
Both tool names follow a consistent verb_noun pattern in snake_case (get_unread_emails, create_draft_reply). The naming is predictable and readable.
With only two tools, the set is quite thin for a Gmail assistant, which typically involves many operations. It is borderline but not an extreme mismatch.
Major gaps exist: no tools for sending emails, reading individual message content, searching, marking as read, or deleting. An agent cannot complete common email workflows with these two tools alone.
Maintenance
Related MCP Connectors
Connect any IMAP/SMTP mailbox to Claude & ChatGPT: search, read, sort, draft. Sends only with OK.
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Connect any mailbox to Claude, ChatGPT & AI: read, send, reply, schedule & search emails.
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.98 npm3MIT
- FlicenseNot gradedqualityDmaintenanceProvides Claude with Gmail capabilities including sending emails, managing drafts, and searching messages.-
- FlicenseNot gradedqualityDmaintenanceEnables reading unread emails and creating draft replies in Gmail via Claude Desktop.-
- FlicenseNot gradedqualityDmaintenanceEnables Claude to read unread emails and create draft replies in Gmail with proper threading.-