Gmail MCP Server

@gkdivya

Repository

Basic information

About Gmail MCP Server

No overview available yet

#gmail #mcp #ai-assistant

Gmail MCP Server config

No standard config provided

This server doesn't expose a parseable MCP config block in its README. See the repository for install instructions.

Repository

Gmail MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Gmail MCP Server?

Gmail MCP Server is a FastMCP-based integration that exposes Gmail operations as tools for AI assistants. It uses Google OAuth 2.0 and the Gmail API to send, read, manage, and trash emails. The project also includes a smart client that leverages Google’s Generative AI (Gemini) to interpret natural language requests.

How to use Gmail MCP Server?

Install dependencies from requirements.txt, place Gmail API OAuth credentials as credentials.json, and set the Gemini API key in a .env file. Start the server with python gmail_server.py --creds credentials.json --token token.json. Then run the smart client with python test_gmail_server.py to interact using natural language commands.

Key features of Gmail MCP Server

Exposes tools: send_email, get_unread_emails, read_email, trash_email, open_email, mark_email_as_read
Includes prompts for email drafting and management
LLM‑powered client understands plain‑English requests
Handles OAuth authentication and automatic token refresh
Parses MIME messages and decodes email headers
Comprehensive logging and error handling

Use cases of Gmail MCP Server

Send an email to a recipient about a specific topic
Check and read unread messages
Open the latest email in the browser
Move an email from a sender to trash
Mark all unread emails as read

Frequently asked questions

What are the prerequisites for using Gmail MCP Server?

Python 3.6+, Gmail API credentials from Google Cloud Console, a Gemini API key from Google AI Studio, and the packages listed in `requirements.txt`.

How does authentication work?

The server uses OAuth 2.0. On first run, it opens a browser for you to log in to Google and grant permissions, then saves a `token.json` file for subsequent requests.

Where are authentication and configuration files stored?

`credentials.json` (OAuth client ID), `token.json` (generated token), and `.env` (Gemini API key) reside in the project root. The `.gitignore` prevents accidental commits of these sensitive files.

How can I add new Gmail operations?

Add the tool implementation in `gmail_server.py`. The smart client automatically discovers and exposes new tools, and the LLM learns to handle requests from the tool descriptions.

Does Gmail MCP Server include a natural language interface?

Yes. The `test_gmail_server.py` client uses Gemini to interpret plain‑English requests (e.g., “Send an email to Alice”) and converts them into the appropriate tool calls, asking for missing information when needed.

Comments

More Communication MCP servers

Nitrosend | AI-Native Email Marketing

Nitrosend

Nitrosend's official remote MCP server. Your agent drafts campaigns, builds automation flows, segments contacts and sends transactional email from Claude, ChatGPT, Cursor or Codex. OAuth sign-in, free plan.

Pidgeon

Email inboxes for AI agents. Give an agent its own address in one call; it sends, receives and replies in threads, waits for a sign-up code and gets it back already extracted, and hands a conversation to a person when it

HelpWell

Workado, LLC

HelpWell connects AI assistants to your help desk, knowledge base, live chat support and email marketing automation for SaaS. Triage support tickets, draft help docs and replies, manage contacts, and prepare newsletters

RelayLink

RelayLink lets your AI assistant send briefings to other people's AI assistants. Draft a package from your current conversation, attach files, approve the note, and the recipient's AI gets the full context: decisions, op

JooVoice

Give your AI agent a phone. JooVoice makes real calls for you in 80+ languages, with local accents, across 67 countries, like booking a table, moving an appointment or chasing a refund, and sends back what happened. Call