mcp-google-workspace

mcp-google-workspace

7

The MCP Google Workspace Server is a Model Context Protocol server specifically designed for Google Workspace services, enabling effective management and interaction with Gmail and Google Calendar through advanced feature integrations. It supports multiple Google accounts with individual metadata and facilitates powerful operations like email querying, event management, and draft handling using OAuth2 authorization.

MCP Google Workspace Server

A Model Context Protocol server for Google Workspace services that provides tools to interact with Gmail and Google Calendar through the MCP protocol.

Features

  • Multiple Google Account Support
    • Use and switch between multiple Google accounts
    • Custom metadata and descriptions per account
  • Gmail Integration
    • Query emails, read content and attachments
    • Create and manage drafts, reply to emails
    • Archive emails, handle attachments, support bulk operations
  • Calendar Integration
    • List calendars, view and manage events
    • Support for multiple calendars and timezones

Prerequisites

  • Node.js >= 18
  • Google Cloud project with Gmail and Calendar APIs enabled
  • OAuth 2.0 credentials

Installation

  1. Clone the repository
  2. Install dependencies
  3. Build the TypeScript code

Usage

  • Start the server and authorize through OAuth2
  • The server will listen for MCP commands

Available Tools

  • Account management, Gmail tools, Calendar tools

Development

  • Source code in TypeScript, uses ES modules
  • Project structure includes services, tools, and types directories