Gmail MCP Server logo

Gmail MCP Server

by highlight-ing

The Gmail MCP Server is a Model Context Protocol server designed to interact with the Gmail API. It allows you to programmatically manage your emails through the MCP interface.

View on GitHub

Last updated: N/A

What is Gmail MCP Server?

This server is a Model Context Protocol (MCP) server that provides tools for interacting with the Gmail API. It enables programmatic management of emails through the MCP interface.

How to use Gmail MCP Server?

To use the server, you need to set up a Google Cloud project, enable the Gmail API, configure OAuth 2.0 credentials, clone the repository, install dependencies, create a credentials.json file with your client ID and secret, obtain a refresh token, configure MCP settings, build the project, and then run the server.

Key features of Gmail MCP Server

  • List recent emails with filtering

  • Advanced email search with 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

  • Automated email processing

  • Integrating Gmail with other applications

  • Programmatically managing email labels

  • Building custom email workflows

FAQ from Gmail MCP Server

What is MCP?

Model Context Protocol (MCP) is a protocol for interacting with various services.

What is the purpose of the refresh token?

The refresh token is used to obtain a new access token when the current access token expires, allowing the server to continuously interact with the Gmail API.

What permissions are required for the Gmail API?

The server requires https://www.googleapis.com/auth/gmail.modify and https://www.googleapis.com/auth/gmail.send permissions to modify and send emails.

Where do I configure the MCP settings?

MCP settings can be configured in the VSCode Claude extension or the Claude desktop app configuration files.

What is the purpose of the build command?

The build command compiles the server's code, preparing it for execution.