Сервер Model Context Protocol для сервисов Google Workspace. Этот сервер предоставляет инструменты для взаимодействия с Gmail и Google Calendar через протокол MCP.

Особенности

** Поддержка нескольких аккаунтов Google** Использование и переключение между несколькими учетными записями Google Каждая учетная запись может иметь пользовательские метаданные и описания.

Gmail Интеграция Запросить электронную почту с расширенным поиском Читать полный контент электронной почты и вложения

• Создание и управление проектами
• Ответить на электронные письма
• Архив электронных писем
• Управлять креплениями
• Поддержка массовых операций

Календарная интеграция

• Список доступных календарей Посмотреть календарные события Создавать новые события
• Исключить события Поддержка нескольких календарей Поддержка пользовательских часовых поясов

Примеры подсказок

Попробуйте этот пример с вашим помощником ИИ:

####Геймплей “Восстановите мои последние непрочитанные сообщения”

• “Поищите мои письма от Мастера Скрама” “Восстановить все электронные письма из бухгалтерии” «Возьмите электронное письмо о ABC и суммируйте его». Напишите хороший ответ на последнее электронное письмо Алисы и загрузите черновик.
• "Отвечайте на письмо Боба с благодарственной запиской. Храните его как черновик.

Календарь

• “Что у меня завтра на повестке дня?”

MCP Google Workspace Server

A Model Context Protocol server for Google Workspace services. This server 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
  • Each account can have custom metadata and descriptions

• Gmail Integration

  • Query emails with advanced search
  • Read full email content and attachments
  • Create and manage drafts
  • Reply to emails
  • Archive emails
  • Handle attachments
  • Bulk operations support

• Calendar Integration

  • List available calendars
  • View calendar events
  • Create new events
  • Delete events
  • Support for multiple calendars
  • Custom timezone support

Example Prompts

Try these example prompts with your AI assistant:

Gmail

• “Retrieve my latest unread messages”
• “Search my emails from the Scrum Master”
• “Retrieve all emails from accounting”
• “Take the email about ABC and summarize it”
• “Write a nice response to Alice’s last email and upload a draft”
• “Reply to Bob’s email with a Thank you note. Store it as draft”

Calendar

• “What do I have on my agenda tomorrow?”
• “Check my private account’s Family agenda for next week”
• “I need to plan an event with Tim for 2hrs next week. Suggest some time slots”

Prerequisites

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

Installation

1. Clone the repository:

   git clone https://github.com/j3k0/mcp-google-workspace.git
   cd mcp-google-workspace
   

2. Install dependencies:

   npm install
   

3. Build the TypeScript code:

   npm run build
   

Configuration

OAuth 2.0 Setup

Google Workspace (G Suite) APIs require OAuth2 authorization. Follow these steps to set up authentication:

1. Create OAuth2 Credentials:

   • Go to the Google Cloud Console
   • Create a new project or select an existing one
   • Enable the Gmail API and Google Calendar API for your project
   • Go to “Credentials” → “Create Credentials” → “OAuth client ID”
   • Select “Desktop app” or “Web application” as the application type
   • Configure the OAuth consent screen with required information
   • Add authorized redirect URIs (include http://localhost:4100/code for local development)

2. Required OAuth2 Scopes:

   [
     "openid",
     "https://mail.google.com/",
     "https://www.googleapis.com/auth/gmail.settings.basic",
     "https://www.googleapis.com/auth/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]
   

3. Create a .gauth.json file in the project root with your Google OAuth 2.0 credentials:

   {
     "installed": {
       "client_id": "your_client_id",
       "project_id": "your_project_id",
       "auth_uri": "https://accounts.google.com/o/oauth2/auth",