send_emailLABSCO SUMMARY
Full mailbox control, and the setup is the selling point.
Gmail servers usually lose people at the Google Cloud step; here the installer takes over once the credentials file is in Downloads and handles naming, placement and client config itself. What you get on the other side is a broad surface — attachments, threads, and label management down to colour and visibility — so an assistant can file mail, not just read it.
What it is
A Gmail server for Claude Desktop that covers sending, reading, searching and labelling. Its distinguishing feature is the setup script: you download the OAuth client secret from Google Cloud, leave it in Downloads, and the installer detects it, renames it and writes the client config.
What you get
- Send mail with attachments, CC, BCC, or as a reply into an existing thread
- Create drafts, including drafts with attachments
- Read a message by ID in text and HTML, chunked when the message is large
- Search with query, labels, sender, has-attachment and pagination
- Pull a whole conversation thread, and download attachments from a message
- Mark messages read, unread, important or not important
- Label management: create, list, rename, recolour, change visibility, search by name, delete by name, add to or remove from a message
Requirements
Claude Desktop, Python 3.11 or higher, git and a Gmail account. In Google Cloud you create a project, enable the Gmail API and add http://localhost:8080/ as an authorised redirect URI — miss that one line and the OAuth round trip fails. Then run python setup.py on Windows or python3 setupUnix.py on macOS and Linux. Configuring by hand, the credentials file goes to credentials/client_secret_gmail_oauth.json. MIT licensed. The README is in Spanish.
Setup effort
Build from source — git clone -b dev https://github.com/FranciscoYuster/claude-client-gmail-mcp.git
USE CASES
01
Clearing a backlog into the right labels
Search with filters, then add or remove labels in bulk and create new ones as needed.
02
Drafting a reply into an existing thread
Pull the whole conversation, then create a draft that lands in the same thread with the attachment already on it.
03
Getting a file out of an old message
Search for the message, then download its attachment without opening the client.
17 tools
Listed in project code.
create_draftread_emailsearch_emailsmodify_labelcreate_label_tooldelete_label_toollist_labels_toolget_or_create_label_toolupdate_label_toolfind_label_by_name_tooldownload_attachmentsget_threadmark_as_readmark_as_unreadmark_as_importantmark_as_not_importantBEFORE YOU INSTALL
What to know first
Tools you get
17 tools registered in the project's code.
Requires
Python 3.11
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone -b dev https://github.com/FranciscoYuster/claude-client-gmail-mcp.git
cd claude-client-gmail-mcp
uv venv
uv pip install -r requirements.txtIn Google Cloud Console create a project, enable the Gmail API, create OAuth credentials with http://localhost:8080/ as an authorized redirect URI, and save the downloaded JSON as credentials/client_secret_gmail_oauth.json inside the project
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"gmail-mcp": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_CLAUDE_CLIENT_GMAIL_MCP>/src",
"run",
"main.py"
]
}
}
}
