Gmail MCP Server

What is Gmail MCP Server?

Gmail MCP Server is a Model Context Protocol (MCP) server that provides tools for interacting with the Gmail API. It enables developers to manage emails programmatically—listing, searching, sending, and modifying messages—through the MCP interface.

How to use Gmail MCP Server?

Ensure Node.js 14+ is installed. Set up a Google Cloud project, enable the Gmail API, and create OAuth 2.0 credentials (Web application) with redirect URI http://localhost:3001/code. Place a credentials.json file in the root directory, then run node get-refresh-token.js to authorize the required scopes (gmail.modify, gmail.send) and obtain a refresh token. Configure your MCP settings file (e.g., cline_mcp_settings.json or claude_desktop_config.json) with the server command pointing to the built index.js and the access token in environment variables. Finally, run npm run build and start the MCP client.

Key features of Gmail MCP Server

• List recent emails with optional filtering
• Advanced email search using Gmail query syntax
• Send new emails with CC and BCC support
• Modify email labels (archive, trash, mark read/unread)

Use cases of Gmail MCP Server

• Automate inbox triage and label management
• Send programmatic replies or notifications via email
• Search for specific emails by sender, subject, or attachment
• Integrate email actions into AI-powered workflows

FAQ from Gmail MCP Server

What dependencies are required to run Gmail MCP Server?

Node.js version 14 or higher, a Google Cloud project with the Gmail API enabled, and OAuth 2.0 credentials (Client ID and Client Secret) are required.

How does authentication work?

The server uses OAuth 2.0 with a refresh token. Run node get-refresh-token.js to open a browser for consent, then the token is saved to token.json and the refresh token is displayed.

What Gmail API permissions does the server request?

It requests two scopes: https://www.googleapis.com/auth/gmail.modify and https://www.googleapis.com/auth/gmail.send.

How do I configure the server in an MCP client?

Add an entry to the mcpServers object in your MCP settings file with command node, args pointing to the built build/index.js, and an environment variable GOOGLE_ACCESS_TOKEN set to the obtained access token.

What email operations can I perform with this server?

You can list emails, search emails using Gmail query syntax, send emails with optional CC/BCC, and modify email labels (e.g., archive, trash, mark as read/unread).