FastMCP Gmail Reader Server
Provides tools for interacting with Gmail to fetch recent emails with pagination and manage email drafts, including creating new messages or replies.
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., "@FastMCP Gmail Reader Server show me my 5 most recent 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.
đź“§ FastMCP Gmail Reader Server
Manage Gmail using a FastMCP API server for Gemini-CLI. Supports reading emails and creating drafts (reply or new).
🚀 Features
Fetch recent emails with pagination
Create reply drafts
Create new email drafts
Related MCP server: Gmail MCP Server
đź”§ Setup
Install Dependencies
pip install uv
cd gemini-tasks-mcp
uv venv
source .venv/bin/activate
uv run main.pyGenerate Google API Credentials
Go to Google Cloud Console.
Create a project and enable Gmail API.
Go to APIs & Services → Credentials.
Click “Create Credentials” → “OAuth client ID” → Application type: Desktop App.
Download
credentials.jsonand place it in the project folder.
Gemini-CLI Configuration
cd ~/.gemini
nano settings.json"mcpServers": {
"gmailReader": {
"command": "uv",
"args": ["run", "main.py"],
"cwd": "<<full-path>>/gemini-email-mcp",
"timeout": 20000
}
}Available Tools
3 toolscreate_new_email_draftA
Create a new draft email (not a reply).
Args: recipient: Email address to send to (can be empty to leave blank). subject: Subject of the email. body_text: Body content of the email.
Returns: A status message about the draft creation.
Inputs: recipient, subject, body_text. Returns: result
create_reply_draftC
Create a reply draft for an email with the given reply text.
Args: email_id: The ID of the email to reply to. reply_text: The text content of the reply.
Returns: A status message about the draft creation.
Inputs: email_id (required), reply_text (required). Returns: result
read_emailsA
Fetch recent emails from Gmail inbox.
Args: max_results: Number of emails to fetch. page_token: Optional page token to fetch next batch.
Returns: Dictionary containing: - email_list: List of email summaries. - nextPageToken: Token to retrieve more emails if available.
Inputs: max_results, page_token. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clearly distinct purpose: create_new_email_draft for new emails, create_reply_draft for replies, and read_emails for fetching emails. There is no overlap in functionality, making it easy for an agent to select the right tool.
All tools follow a consistent verb_noun pattern with snake_case: create_new_email_draft, create_reply_draft, and read_emails. The naming is predictable and readable throughout the set.
With only 3 tools, the server feels thin for a Gmail reader, as it lacks operations like updating drafts, deleting emails, or managing labels. While the core functions are present, the scope is limited compared to typical email management needs.
The tool set is severely incomplete for a Gmail server. It only supports creating drafts and reading emails, missing essential CRUD operations like sending emails, updating drafts, deleting emails, or accessing other Gmail features such as labels or attachments. This will likely cause agent failures in broader email workflows.
Maintenance
Related MCP Connectors
Manage Gmail end-to-end: search, read, send, draft, label, and organize threads. Automate workflow…
Manage Gmail messages, threads, labels, drafts, and settings from your workflows. Send and organiz…
Search Gmail and Outlook, save drafts, manage email rules, and view email stats.
Read and search FranklyMail email and prepare drafts, replies, and forwards for human approval.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Gmail through the Gmail API to read, send, and manage emails. Supports multiple Gmail accounts with real-time monitoring and advanced features for email search and attachment handling.18Apache 2.0
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Gmail through the Gmail API with OAuth2 authentication. Supports reading, sending, searching emails, and managing read status through natural language.-
- FlicenseNot gradedqualityNot gradedmaintenanceEnables interaction with Gmail through the Gmail API, allowing users to list, read, search emails, create and send drafts, and get email summaries through natural language commands with OAuth2 authentication.-
- FlicenseNot gradedqualityDmaintenanceEnables interaction with Gmail through the Gmail API to read unread messages, retrieve email threads, and create draft replies programmatically. Supports OAuth authentication and automated email processing through natural language.-