MM

markuspfundstein/mcp-gsuite

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

491 stars 100 forks 품질 69 트렌드 20MIT

Google Gsuite 프로덕트와 상호작용할 수 있는 MCP 서버

개요

구글 제품과 상호작용할 수 있는 MCP 서버입니다. 현재 이 MCP 서버는 다음과 같은 기능을 통해 Gmail과 캘린더 통합을 지원합니다: 2. Gmail * Gmail 사용자 정보 얻기 * 유연한 검색으로 이메일 조회(예: 읽지 않음, 특정 발신자, 날짜 범위, 첨부 포함) * ID별로 이메일 전체 콘텐츠 검색 * 수신자, 제목, 본문, 참조 옵션이 포함된 새 초안 이메일 생성 * 초안 이메일 삭제 * 기존 이메일에 답장하기(즉시 전송 또는 초안 저장 가능) * 여러 이메일을 ID로 동시에 검색하기. * 이메일에서 로컬 시스템으로 여러 첨부파일을 저장하기. 3.

개요(AI 번역)

구글 제품과 상호작용할 수 있는 MCP 서버입니다.

예시 프롬프트

현재 이 MCP 서버는 다음과 같은 기능을 통해 Gmail과 캘린더 통합을 지원합니다:

  1. 일반
  • 여러 개의 구글 계정
  1. Gmail
  • Gmail 사용자 정보 받기
  • 유연한 검색이 가능한 이메일 조회 (예: 읽지 않음, 특정 발신자, 날짜 범위, 첨부파일 포함)
  • ID별 이메일 전체 콘텐츠 조회
  • 수신자, 제목, 본문 및 참조 옵션을 포함한 새 초안 이메일 생성
  • 초안 이메일 삭제
  • 기존 이메일에 답장하기(즉시 보내거나 초안으로 저장할 수 있음)
  • 여러 이메일을 동시에 ID로 검색하세요.
  • 이메일에서 로컬 시스템으로 여러 첨부파일을 저장하세요.
  1. 달력
  • 여러 달력 관리
  • 지정된 시간대 내 일정 행사 가져오기
  • 다음 항목으로 일정 행사를 생성하세요:
  • 제목, 시작/종료 시간
  • 선택적 위치 및 설명
  • 선택 참석자
  • 커스텀 시간대 지원
  • 알림 선호도
  • 캘린더 이벤트 삭제

시도해볼 수 있는 예시 프롬프트:

  • 내 최신 읽지 않은 메시지 찾아
  • 스크럼 마스터에서 내 이메일을 검색하기
  • 회계부에서 모든 이메일을 찾아
  • ABC에 관한 이메일을 받아 요약해 보세요

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.

README

원문 README의 일부입니다. 원문 보기.

mcp-gsuite MCP server

MCP server to interact with Google products.

Example prompts

Right now, this MCP server supports Gmail and Calendar integration with the following capabilities:

  1. General
  • Multiple google accounts
  1. Gmail
  • Get your Gmail user information
  • Query emails with flexible search (e.g., unread, from specific senders, date ranges, with attachments)
  • Retrieve complete email content by ID
  • Create new draft emails with recipients, subject, body and CC options
  • Delete draft emails
  • Reply to existing emails (can either send immediately or save as draft)
  • Retrieve multiple emails at once by their IDs.
  • Save multiple attachments from emails to your local system.
  1. Calendar
  • Manage multiple calendars
  • Get calendar events within specified time ranges
  • Create calendar events with:
    • Title, start/end times
    • Optional location and description
    • Optional attendees
    • Custom timezone support
    • Notification preferences
  • Delete calendar events

Example prompts you can try:

  • 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

  • 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.

Quickstart

Install

Installing via Smithery

To install mcp-gsuite for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-gsuite --client claude

Oauth 2

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/calendar",
     "https://www.googleapis.com/auth/userinfo.email"
   ]
  1. Then create a .gauth.json in your working directory with client
{
    "web": {
        "client_id": "$your_client_id",
        "client_secret": "$your_client_secret",
        "redirect_uris": ["http://localhost:4100/code"],
        "auth_uri": "https://accounts.google.com/o/oauth2/auth",
GitHub에서 전체 README 보기

설치

uvx mcp-gsuite --accounts-file /path/to/custom/.accounts.json --credentials-dir /path/to/custom/credentials
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "mcp-gsuite": { "command": "uv", "args": [ "--directory", "<dir_to>/mcp-gsuite", "run", "mcp-gsuite" ] } } }