Google Workspace MCP Server logo

Google Workspace MCP Server

by mattcoatsworth

A Model Context Protocol (MCP) server for interacting with Google Workspace APIs. It supports Gmail, Drive, Calendar, Docs, Sheets, and Slides.

View on GitHub

Last updated: N/A

What is Google Workspace MCP Server?

This is a Model Context Protocol (MCP) server designed to facilitate interaction with various Google Workspace APIs, including Gmail, Drive, Calendar, Docs, Sheets, and Slides. It provides a set of tools and resources to manage and manipulate data within these services.

How to use Google Workspace MCP Server?

To use this server, you need to install Node.js 16+, have a Google Cloud project with the necessary APIs enabled, and obtain OAuth 2.0 client credentials. After installing the dependencies with npm install, configure the .env file with your Google API credentials. Start the server using npm run dev and test it with the MCP Inspector using npm run inspect. Follow the authentication steps to obtain a refresh token if needed.

Key features of Google Workspace MCP Server

  • Gmail API integration (send emails, list messages, manage labels)

  • Drive API integration (list files, create folders, upload files)

  • Docs API integration (create and edit Google Docs)

  • Sheets API integration (read and write spreadsheet data)

  • Slides API integration (create presentations and slides)

  • Calendar API integration (list and create calendar events)

  • OAuth2 authentication flow helpers

Use cases of Google Workspace MCP Server

  • Automating email tasks such as sending notifications or managing inboxes.

  • Programmatically managing files and folders in Google Drive.

  • Creating and editing Google Docs, Sheets, and Slides through code.

  • Integrating Google Calendar events with other applications.

  • Building custom applications that leverage Google Workspace APIs.

FAQ from Google Workspace MCP Server

What is MCP?

MCP stands for Model Context Protocol. It's a protocol for interacting with APIs.

What Google Workspace APIs are supported?

The server supports Gmail, Drive, Calendar, Docs, Sheets, and Slides APIs.

What are the prerequisites for using this server?

You need Node.js 16+, a Google Cloud project with the necessary APIs enabled, and OAuth 2.0 client credentials.

How do I install the server?

Run npm install in the project directory.

How do I configure the server?

Copy .env.example to .env and edit the file with your Google API credentials (CLIENT_ID, CLIENT_SECRET, REDIRECT_URI, REFRESH_TOKEN).