Gmail MCP
About
Manage your Gmail account, including sending, reading, and organizing emails.
Details
- Author
- vinayak-mehta
- Categories
- Communication, Other, Automation, Productivity
Jump to
Setup
Install Gmail MCP in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/vinayak-mehta/gmail-mcp
Follow the installation instructions in the repository README, then restart your MCP client.
Allow Claude to search and retrieve emails from your Gmail account.
- Visit theGoogle Cloud Console
- Create a new project or select an existing one
- Enable the Gmail API for your project
- Navigate to "APIs & Services" > "Library"
- Search for "Gmail API" and enable it
- Go to "APIs & Services" > "Credentials"
- Click "Create Credentials" > "OAuth client ID"
- Select "Desktop application" as the application type
- Name your client and click "Create"
Run the authorization command to generate your token:
uv run gmail-mcp auth --creds-path credentials.json --token-path token.json
This will open a browser window where you'll need to log in to your Google account and grant the necessary permissions. After authorization, atoken.jsonfile will be created in your project directory.
Add the Gmail MCP server to your Claude configuration file:
{ "mcpServers": { "gmail": { "args": [ "--from", "git+https://github.com/vinayak-mehta/gmail-mcp", "gmail-mcp" ], "command": "/Users/username/.local/bin/uvx", "env": { "GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json", "GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json" } } } }
- Replace/Users/username/path/to/gmail-mcpwith your actual project path
- Adjust thecommandpath to your installeduvxexecutable
- Provide correct paths to yourcredentials.jsonandtoken.jsonfiles
Claude will now have access to the following tools:
Search for emails in your Gmail account.
Example prompt:"Search for all emails fromexample@gmail.com"
Retrieve the full content of a specific email.
Example prompt:"Show me the full content of the email with the subject 'Meeting Tomorrow'"
List recent messages from your Gmail inbox.
Example prompt:"List my 5 most recent emails"
You can configure the paths to your credentials and token files using environment variables:
- GMAIL_CREDS_PATH: Path to your credentials.json file
- GMAIL_TOKEN_PATH: Path to your token.json file
Create a.envfile in the project root with these variables for easy configuration.
Query live Gmail data using LLMs via CData's read-only MCP server.
Search and delete emails in your Gmail account.
Enables AI assistants to manage Gmail through natural language interactions.
A standardized interface for managing, sending, and retrieving emails through the Gmail API.
A super simple and tiny MCP server for gmail in python
Allows AI agents to search Gmail threads, learn your writing style, and draft emails.
An MCP server that enables AI models to interact directly with the Gmail API to manage emails.
An MCP server for integrating with the Gmail API to manage emails.
Most email MCP servers only read from IMAP. mail-mcp does everything: 30 tools for reading, searching, sending, replying, forwarding, and bulk operations across IMAP, SMTP, Microsoft Graph API, and Exchange Web Services. Multi-account, native OAuth2, built in Rust. Works with Gmail, Microsoft 365, Hotmail/Outlook.com, Zoho, and any standard IMAP/SMTP server.
MCP server for structured, read-only email access. Exposes a minimal, auditable API surface — AI agents can search and read emails, but cannot send, delete, or modify your mailbox.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
