Gmail
About
Tools for common Gmail operations, such as sending emails.
Details
- Author
- heuristech
- Categories
- Communication, Other, Automation
Jump to
Setup
Install Gmail in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/heuristech/gmail-mcp-server
Follow the installation instructions in the repository README, then restart your MCP client.
This MCP (Model Context Protocol) server provides tools for common operations with gmail.
- Python 3.12+
- uv- Fast Python package installer and resolver
- Google Cloud Console Setup
- Go to:Google Cloud Console
- Create a new project for this MCP Server
- Enable Gmail API
- Go to:APIs and services > Library
- Search:Gmail API
- Click on:Gmail APItile in the results
- Click on:Enable
- Go to:APIs and services > Credentials
- Click on":Create Credentials > OAuth client ID
- Choose Application Type:Web application
- Add:Authorised redirect URIs:http://localhost:4321/
- Create client
- Download the JSON and save it tocredentials.jsonin this project root. This has theClient ID,Client Secret, etc.
git clone https://github.com/heuristech/gmail-mcp-server.git cd gmail-mcp-server
Create a virtual environment and install the package in development mode:
# Create a virtual environment uv venv # Activate the virtual environment # On macOS/Linux: source .venv/bin/activate # On Windows: .venv\Scripts\activate # Install dependencies uv sync
- Start a server onport:4321to receivetokenspost Google OAuth
- Open your browser for Google OAuth
- On succeeful authentication it will savetoken.jsonwithrefresh_tokenalong withclient_id, andclient_secret.
- It will also display therefresh_tokenon console.
Setup the corresponding value using what you received in the previous step.
Use MCP Inspector to test it in the development mode.
Once your server is ready, install it in Claude Desktop
mcp install server.py --with google-auth --with google-auth-oauthlib --with google-auth-httplib2 --with google-api-python-client -f .env
{ "mcpServers": { "gmail-mcp-server": { "command": "uv", "args": [ "--directory", "/:your.path.to/gmail-mcp-server/server.py", "run", "server.py" ], "env": { "CLIENT_ID": "google.auth.app.client.id", "CLIENT_SECRET": "google.auth.app.client.secret", "REFRESH_TOKEN": "google.auth.app.refresh.token" } } } }
Send emails via SMTP. Requires SMTP server credentials to be configured through environment variables.
Query live Gmail data using LLMs via CData's read-only MCP server.
Provides comprehensive integration with Gmail for reading, searching, and sending emails.
An MCP server for Gmail, allowing AI assistants to manage emails through natural language.
Search and delete emails in your Gmail account.
Enables AI assistants to manage Gmail through natural language interactions.
An MCP server for integrating Gmail with auto-authentication support.
A standardized interface for managing, sending, and retrieving emails through the Gmail API.
Manage your Gmail account, including sending, reading, and organizing emails.
An MCP server for interacting with your Gmail account using AI assistants.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.


