Gmail MCP Server
About
Gmail MCP Server is an MCP (Model Context Protocol) server that provides Gmail integration capabilities to MCP clients like Claude Desktop. It uses secure OAuth2 authentication to read emails from your Gmail account.
Explore
- View recent emails from your Gmail inbox
- Search emails using Gmail's search syntax
- Secure OAuth2 authentication with Gmail API
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Gmail MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Google Cloud Project Setup
1. Create a Google Cloud Project at https://console.cloud.google.com/ 2. Enable the Gmail API 3. Create OAuth 2.0 credentials: - Application type: Desktop application - Download the credentials ascredentials.jsonsearch_emails
Description: Search Gmail emails with a query
query
(required): Gmail search query (uses Gmail's standard search syntax)
max_results
(optional): Maximum number of results to return (default: 10)
- search_emails
- Description: Search Gmail emails with a query
- Parameters:
- query (required): Gmail search query (uses Gmail's standard search syntax)
- max_results (optional): Maximum number of results to return (default: 10)
Example search:
Could you show me any emails from sanrio in the last two days?
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gmail mcp server": {
"ajbr0wn_gmail-mcp-server": {
"command": "python",
"args": [
"-m",
"gmail_mcp_server.server"
]
}
}
}
}McpServers
{
"ajbr0wn_gmail-mcp-server": {
"command": "python",
"args": [
"-m",
"gmail_mcp_server.server"
]
}
}An MCP (Model Context Protocol) server that provides Gmail integration capabilities to MCP clients like Claude Desktop.
Features
- View recent emails from your Gmail inbox
- Search emails using Gmail's search syntax
- Secure OAuth2 authentication with Gmail API
Setup
1. Google Cloud Project Setup
1. Create a Google Cloud Project at https://console.cloud.google.com/ 2. Enable the Gmail API 3. Create OAuth 2.0 credentials: - Application type: Desktop application - Download the credentials ascredentials.json
2. Installation
```bashSign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
