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

DemandBird

Write, schedule and publish social posts in your own voice, and read your analytics, from Claude, ChatGPT or any MCP client. Works with LinkedIn, X, Threads, Bluesky, Facebook, Instagram and more. Hosted, with OAuth sign

Odile Direct by Odile Labs

Odile Labs

Odile Direct: AI agents reach a real business by its phone number. Look a business up free, leave a message, check open times or book a slot, then read the owner's reply in the same thread. 50 free tasks a month per agen

DashaMail

MCP server for DashaMail email marketing service

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

SocialRobot

socialrobot-io

Schedule and analyze social media posts from Claude, ChatGPT, Cursor, or Gemini. SocialRobot's remote MCP server connects Instagram, LinkedIn, X, TikTok, Facebook, Threads, Pinterest, Bluesky, and Mastodon, then creates,