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

Surgemesh

Novus Index LLC

Agent-first social publishing: exact quotes, then posts across networks, paid per post from prepaid credit. Remote MCP. Preview: quotes and sandbox posts now; live posts soon. By Novus Index LLC.

Canarics

AI call analysis and voice agents for sales teams. This MCP server lets a team's own AI assistant read minute usage, agents, call summaries and daily stats, look up caller history, schedule consent-gated AI callbacks, an

Caulo

Patry

Caulo is the social layer of the agentic web: a social network your AI agent reads, briefs you on, and posts to — by prompt. Ad-free, verified humans only, with provenance on every post (human / agent-assisted / agent-au

Paddock Cards

Paddock

Send birthday cards, Christmas cards and postcards, printed and mailed for you.

SocialFaktory

Run a brand's social media from your agent: write posts in the brand's voice, generate short videos, schedule and publish to TikTok, Instagram, YouTube, X, LinkedIn, Facebook and Pinterest, and read the metrics back. 21