Gmail MCP Server

MCPOpen Source10.0

by jeasonzhang-eth • Messaging & Collaboration

An MCP-compatible Python server that exposes Gmail inbox data (threads, messages, unread counts) via OAuth2 and the Gmail API.

Example Use Cases

1
Access and fetch a user's recent Gmail threads and messages through MCP for summarization or triage workflows.
2
Message contents and metadata (including unread counts) in JSON format for downstream processing, indexing, or search.
3
A secure, OAuth2-based bridge between Gmail and MCP-enabled clients, with examples for integrating into Claude or cursor.

Description

Gmail MCP is a Python-based server that lets MCP clients access a user's Gmail inbox by authenticating with Google OAuth2 and calling the Gmail API. It can fetch recent email threads, return message contents and metadata, and report unread message counts, all formatted as JSON for easy integration. The project includes a local server entrypoint, a test mode to verify access, and examples for adding the service to MCP clients such as Claude and cursor.

Capabilities(6 total)

Tools (6)

perform-email-search

Searches the user's Gmail with various filters and returns complete contents.

sender:stringrecipient:stringsubject:stringhas_attachment:booleanfiledoes ame:stringnewer_than_days:integerolder_than_days:integerlabel:stringis_unread:booleankeywords:string

modify-draft-prompt

Automatically adapts email writing style when user expresses preferences or concerns about communication style. This tool helps maintain personalized communication patterns for different contacts and contexts.

new_requirements:string*

list-new-emails

Retrieves and lists all new emails found during Gmail index update.

get-draft-prompt

Retrieves the draft prompt template for composing a response. IMPORTANT: After getting this prompt: 1. Use it IMMEDIATELY to write your draft 2. Call write-draft-email with your draft Only call this tool when you have all needed information and are ready to write.

write-draft-email

Shows the draft email to the user in the chat. IMPORTANT: After calling this tool: 1. Present the draft content directly in your message (don't leave it in the expandable window) 2. Ask the user to review and reply with 'SEND' to approve This tool helps ensure drafts are always properly shown to users before sending.

to:string*subject:string*message_id:string*thread_id:string*draft_content:string*

Quick Actions

View on GitHub

Security

Scanned 2 month(s) ago

Risk Level

MINIMAL

Read-only data retrieval, no side effects

Trust Score

C52/100

5/17 checks passed

Scores are informational only and provided “as is” without warranty. AgentHotspot assumes no liability for actions taken based on these ratings.

Quick Stats

Service TypeMCP

Pricing ModelFree

Capabilities6 Tools / 0 Prompts / 0 Resources

Ownerjeasonzhang-eth

CategoryMessaging & Collaboration

DependenciesStandalone

Set Your Username