mcp-gsuite logo

mcp-gsuite

by MarkusPfundstein

mcp-gsuite is an MCP server designed to interact with Google products, specifically Gmail and Calendar. It allows users to manage emails, calendar events, and retrieve information from their Google accounts through a standardized interface.

View on GitHub

Last updated: N/A

What is mcp-gsuite?

mcp-gsuite is an MCP (Model Context Protocol) server that provides an interface for interacting with Google's Gmail and Calendar services. It allows users to perform various actions such as querying emails, creating drafts, managing calendar events, and retrieving user information.

How to use mcp-gsuite?

To use mcp-gsuite, you need to install it via Smithery or manually. You'll need to set up OAuth2 authentication with Google Cloud Console, enabling the Gmail and Calendar APIs. Configure the necessary OAuth2 scopes and create .gauth.json and .accounts.json files with your credentials and account information. Finally, configure Claude Desktop to use the server.

Key features of mcp-gsuite

  • Gmail integration (querying, retrieving, creating drafts, replying, managing attachments)

  • Calendar integration (managing multiple calendars, getting events, creating events with attendees and notifications, deleting events)

  • Support for multiple Google accounts

  • Flexible email search options

  • Custom timezone support for calendar events

Use cases of mcp-gsuite

  • Retrieving and summarizing important emails

  • Automating email responses and draft creation

  • Scheduling and managing calendar events with attendees

  • Querying upcoming events and managing agendas

  • Integrating Google services with AI assistants like Claude

FAQ from mcp-gsuite

How do I install mcp-gsuite?

You can install it via Smithery using the command npx -y @smithery/cli install mcp-gsuite --client claude or manually by following the steps in the README.

What is OAuth2 and why is it required?

OAuth2 is a standard authorization protocol required by Google Workspace APIs. It allows mcp-gsuite to access your Gmail and Calendar data securely with your permission.

How do I set up OAuth2 credentials?

You need to create a project in the Google Cloud Console, enable the Gmail and Calendar APIs, and create an OAuth client ID. Configure the OAuth consent screen and add authorized redirect URIs.

What are the required OAuth2 scopes?

The required scopes are openid, https://mail.google.com/, https://www.googleapis.com/auth/calendar, and https://www.googleapis.com/auth/userinfo.email.

Where are the OAuth credentials stored after successful authentication?

The credentials are stored in a local file called .oauth.{email}.json in the credentials directory after the first successful login.