Gmail
About
Integrates Gmail functionality, enabling email search, message retrieval, and attachment downloads via Google Apps Script.
Details
- Author
- kazuph
- Repository
- kazuph/mcp-gmail-gas
- GitHub stars
- 9
- Downloads
- 945
- License
- MIT License
- Categories
- Productivity, AI, Design, Search, Infrastructure, Communication, Developer Tools
Jump to
Setting up with Highlight
Follow these steps to add this server as a custom Highlight plugin:
- 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
GmailCommand (node, npx, python, etc.)npxArguments-
Argument 1
-y -
Argument 2
@kazuph/mcp-gmail-gas
Environment-
GAS_ENDPOINT
YOUR_DEPLOYMENT_URL -
VALID_API_KEY
YOUR_API_KEY
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
-
Argument 1
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Deploy the Google Apps Script
- Visit Google Apps Script and create a new project
- Copy the entire contents of code.gs and paste it into the script editor
- Click on "Deploy" > "New deployment"
- Select "Web app" as the deployment type
- Configure the following settings:
- Execute as: Me
- Who has access: Anyone
- Click "Deploy"
- When prompted, review and authorize the app to access your Gmail account
- Copy the deployment URL and generate a random API key for security
gmail_search_messages
Search for emails using Gmail search query syntax (e.g., 'subject:Meeting newer_than:1d')
gmail_get_message
Get the full content and details of a specific email
gmail_download_attachment
Download an attachment from a specific email
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"gmail": {
"env": {
"GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
"VALID_API_KEY": "YOUR_API_KEY"
},
"args": [
"-y",
"@kazuph/mcp-gmail-gas"
],
"command": "npx"
}
}
}Linux
{
"env": {
"GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
"VALID_API_KEY": "YOUR_API_KEY"
},
"args": [
"-y",
"@kazuph/mcp-gmail-gas"
],
"command": "npx"
}Macos
{
"env": {
"GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
"VALID_API_KEY": "YOUR_API_KEY"
},
"args": [
"-y",
"@kazuph/mcp-gmail-gas"
],
"command": "npx"
}Windows
{
"env": {
"GAS_ENDPOINT": "YOUR_DEPLOYMENT_URL",
"VALID_API_KEY": "YOUR_API_KEY"
},
"args": [
"/c",
"npx",
"-y",
"@kazuph/mcp-gmail-gas"
],
"command": "cmd"
}MCP Gmail
Model Context Protocol server for Gmail integration. This allows Claude Desktop (or any MCP client) to interact with your Gmail account through Google Apps Script.
<a href="https://glama.ai/mcp/servers/7awla69pjq"></a>
Quick Start (For Users)
Prerequisites
- Node.js 18+ (install viabrew install node)
- Gmail account
- Google Apps Script deployment
- Claude Desktop (install from https://claude.ai/desktop)
Configuration
1. Deploy the Google Apps Script
- Visit Google Apps Script and create a new project
- Copy the entire contents of code.gs and paste it into the script editor
- Click on "Deploy" > "New deployment"
- Select "Web app" as the deployment type
- Configure the following settings:
- Execute as: Me
- Who has access: Anyone
- Click "Deploy"
- When prompted, review and authorize the app to access your Gmail account
- Copy the deployment URL and generate a random API key for security
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
