Skip to main content
Glama
FastMCP Gmail Reader Server

FastMCP Gmail Reader Server

by chronis10

đź“§ 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.py

Generate Google API Credentials

  1. Go to Google Cloud Console.

  2. Create a project and enable Gmail API.

  3. Go to APIs & Services → Credentials.

  4. Click “Create Credentials” → “OAuth client ID” → Application type: Desktop App.

  5. Download credentials.json and 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 tools
create_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

    B3.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count3/5

    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.

    Completeness2/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      18
      Apache 2.0
    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables 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.
      -