MCP SERVERSearch, read, label and answer Gmail from an agent, with thread reconstruction that pulls out participants, deadlines and follow-ups.
LABSCO SUMMARY
Most Gmail servers stop at search and read. This one adds analyze_conversation, which reconstructs a full thread from a single email — forwards and replies included — and comes back with participants, a timeline, and per-message ratings for importance, urgency and deadlines. Attachments follow a deliberate two-step path: list them, then download, which is what stops an agent from guessing attachment IDs.
A Gmail server that runs against your own Google Cloud OAuth credentials. It covers the mailbox operations — search, read, send, label, delete, drafts, attachments — plus a conversation analyzer that reads a whole thread at once.
A Google Cloud project with the Gmail API enabled and OAuth2 desktop credentials of your own — download credentials.json into the project root and set GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET and GOOGLE_REDIRECT_URI. Its package.json is marked private, so you install from source: clone it, run npm install and npm run build, then point your client at node build/index.js over stdio. Node.js 18+. STORAGE_PATH, CACHE_TTL and LOG_LEVEL are optional. The first call to gmail_authenticate returns a clickable link that completes the OAuth flow.
Build from source — git clone https://github.com/kushal45/GmailMcpServer.git
USE CASES
Hand one message to the analyzer and read back the reconstructed conversation, who is in it, and what is due.
Search in ordinary phrasing and narrow with sender, label or date range when too much comes back.
List the attachments on the message first, then download the one you want — it is saved locally and the path comes back with it.
Create the draft, review it, update it, and send it when you are satisfied — all through the draft tool.
Search the backlog, move each message to the right label while stripping the old ones, and mark it read.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
analyze_conversationAnalyze a conversation thread for a given email. Reconstructs the full thread (including forwards/replies), extracts participants, timeline, topics, references, and classifies each email for importance, urgency, deadlines, and suggests proactive reminders.
gmail_authenticateAuthenticate with Gmail using manual authentication (provides clickable link). Secure and compatible with all environments.
gmail_delete_emailPermanently delete an email message. Use with caution as this action cannot be undone.
gmail_draftComprehensive draft email management. Create, list, get, update, delete, and send drafts through a single tool.
gmail_get_attachmentDownload Gmail attachment and automatically save to local file system. Base64 content is decoded to binary file and saved with unique timestamped filename. Returns full file path and file:// URL for direct access. IMPORTANT: Use 'gmail_list_attachments' first to see available attachments, then use the index (0, 1, 2, etc.) or copy the exact attachmentId from the list.
gmail_list_attachmentsREQUIRED FIRST STEP: List all attachments in a Gmail message before downloading. Shows attachment index, ID, filename, content type, and size. Use the index (0, 1, 2, etc.) or copy the exact attachmentId for gmail_get_attachment.
gmail_logoutSign out and clear Gmail authentication credentials. Useful for switching accounts or ending the session.
gmail_mark_emailMark email as read or unread. Useful for managing email status and organizing your inbox.
gmail_move_emailMove email to different label/folder. Can add labels and remove existing ones in a single operation.
gmail_performance_metricsGet comprehensive performance metrics including cache hit rates, memory usage, batch operation efficiency, and connection pool statistics.
gmail_read_emailRead email message by ID with advanced MIME structure handling. Returns full email content including headers, body, and attachment information.
gmail_search_emailsEnhanced email search with natural language processing, fuzzy matching, and cross-reference detection. Supports queries like 'Find income tax notice from May' or 'Show me emails about PAN ANYPS1039E'. Automatically detects natural language and applies intelligent matching.
gmail_send_emailSend an email message with support for HTML content, attachments, and international characters. Supports both plain text and HTML emails with proper multipart structure. For attachments: use base64 encoded content OR provide ABSOLUTE file paths (e.g., '/full/path/to/file.pdf'). Relative paths will fail.
gmail_system_statusCheck the system status including feature availability, circuit breaker states, and resilience metrics.
BEFORE YOU INSTALL
14 tools when we connected.
The documented client runs the server on your machine.
INSTALLATION
git clone https://github.com/kushal45/GmailMcpServer.git
cd GmailMcpServerIn Google Cloud Console, enable the Gmail API, create OAuth2 credentials (Desktop application) and download credentials.json to the project root
cp .env.example .envEdit .env: set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET (GOOGLE_REDIRECT_URI defaults to http://localhost:3000/oauth2callback)
mkdir -p data logs archives
npm install
npm run build{
"mcpServers": {
"gmail": {
"command": "node",
"args": [
"<YOUR_PATH_TO_GMAIL_MCP_SERVER>/build/index.js"
],
"env": {
"NODE_ENV": "production"
}
}
}
}<YOUR_PATH_TO_GMAIL_MCP_SERVER> is the full path of the GmailMcpServer folder you cloned and built. build/index.js exists only after npm run build.
The configuration on this page does not set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET; the project's instructions put them in a .env file. To supply them without depending on where the server looks for that file, use the block's "env" section.
MCP servers
ivan-rivera-projects
Shy2593666979
acro5piano
bastienchabal