Gmail

by heuristech

Not rated
GitHub

About

Tools for common Gmail operations, such as sending emails.

Details

Author
heuristech
Categories
Communication, Other, Automation

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.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.