Googleワークスペースサービスのモデルコンテキストプロトコルサーバー。 このサーバーは、MCP プロトコルを介して Gmail と Google カレンダーとやり取りするツールを提供します。

##特徴

• 複数のGoogleアカウントサポート

• 複数のGoogleアカウントの使用と切り替え

• 各アカウントはカスタムメタデータと説明を持つことができます

• Gmailの統合

• 高度な検索でメールを問い合わせる

• 完全な電子メールの内容および付属品を読んで下さい

• 草案の作成と管理

• 電子メールへの返信

• アーカイブメール

• ハンドルアタッチメント

• バルク操作サポート

• カレンダーインテグレーション

• 利用可能なカレンダーのリスト

• カレンダーイベントを見る

• 新しいイベントを作成する

• イベントの削除

• 複数のカレンダーのサポート

• カスタムタイムゾーンのサポート

サンプルプロンプト

これらの例をAIアシスタントで試してみましょう。

#####Gmailの

• 「最新の未読メッセージを取得する」
• 「スクラムマスターからメールを探す」
• 「会計からすべてのメールを取得する」
• 「ABCについてのメールを受け取り、それをまとめる」
• 「Aliceの最後のメールに素敵な反応をして原稿をアップロード」
• 「ありがとう」とボブのメールに返信します。 ドラフトとして保存」

カレンダー

• 「明日、自分の議題に何か?」

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",