Search EmailsLABSCO SUMMARY
Reads your mail, and only reads it.
Three capabilities, all read: search, list, fetch. Nothing sends, deletes or labels, which makes the OAuth grant easier to reason about than a full-access mail integration. The cost is the setup — you build the Google Cloud OAuth client yourself, which is a few console screens before the first query.
What it is
A read-only MCP server over the Gmail API. You create your own OAuth client in Google Cloud, authorize it once from the command line, and the server uses the resulting token to answer questions about your mailbox.
What you get
- Emails found by a search — the same queries you would type into Gmail, such as everything from one sender
- The full content of one message pulled back, addressed by its subject or the search that found it
- Recent messages from the inbox listed, with a count you choose
Requirements
Your own Google Cloud project with the Gmail API enabled and a Desktop-application OAuth client; download the credentials JSON and save it as credentials.json. Authorize once with uv run gmail-mcp auth --creds-path credentials.json --token-path token.json, which opens a browser and writes token.json. Point the server at both files through GMAIL_CREDS_PATH and GMAIL_TOKEN_PATH, and run it with uvx --from git+https://github.com/vinayak-mehta/gmail-mcp gmail-mcp. The package is gmail-mcp 0.1.0.
Setup effort
One command plus credentials — uvx --from git+https://github.com/vinayak-mehta/gmail-mcp gmail-mcp, then supply credentials
USE CASES
01
Finding every thread with one person
Search the mailbox by sender and get the matching messages back in the conversation, without switching to the Gmail tab.
02
Reading a message you can only half-remember
Ask for the full content of the email by its subject and get the body rather than a snippet.
03
Skimming what arrived while you were heads-down
List the last handful of inbox messages and decide what needs an answer.
3 tools
Listed in project docs. Your client may show a different list.
Get Email ContentList MessagesBEFORE YOU INSTALL
What to know first
Tools you get
3 tools named in the project's documentation.
Requires
- uvx on PATH
- GMAIL_CREDS_PATH in your environment
- GMAIL_TOKEN_PATH in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx --from git+https://github.com/vinayak-mehta/gmail-mcp gmail-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"gmail": {
"args": [
"--from",
"git+https://github.com/vinayak-mehta/gmail-mcp",
"gmail-mcp"
],
"command": "/Users/<YOUR_USERNAME>/.local/bin/uvx",
"env": {
"GMAIL_CREDS_PATH": "/Users/<YOUR_USERNAME>/<YOUR_PATH_TO_GMAIL_MCP>/credentials.json",
"GMAIL_TOKEN_PATH": "/Users/<YOUR_USERNAME>/<YOUR_PATH_TO_GMAIL_MCP>/token.json"
}
}
}
}
