Google Workspace 서비스에 대한 모델 Context Protocol 서버. 이 서버는 MCP 프로토콜을 통해 Gmail 및 Google 캘린더와 상호 작용하는 도구를 제공합니다.

특징

• Multiple Google 계정 지원

• 여러 Google 계정 사이 사용 및 전환

• 각 계정은 사용자 정의 메타 데이터 및 설명을 가질 수 있습니다.

• **Gmail 통합 **

• 고급 검색 Query 이메일

• 전체 이메일 내용 및 첨부 파일 읽기

• 생성 및 관리

• 이메일 답변

• 보관 이메일

• 핸들 첨부

• 대량 가동 지원

• **Calendar 통합 **

• 사용 가능한 달력

• 달력 행사보기

• 새 이벤트 만들기

• 행사 삭제

• 여러 캘린더 지원

• 주문 timezone 지원

예 Prompts

이 예제를 AI Assistant로 시도하십시오.

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