a-bonus/google-docs-mcp

해결하는 문제

이 프로젝트는 AI 어시스턴트(Claude Desktop, Cursor, Windsurf 등)가 Google Workspace 생태계와 직접 상호작용할 수 있도록 해주는 Model Context Protocol (MCP) 서버를 제공합니다. 수동 복사/붙여넣기의 필요성을 제거하고, LLM이 Google Docs, Sheets, Drive, Gmail, Calendar의 콘텐츠를 읽고 생성하며 수정할 수 있도록 합니다.

작동 방식

서버는 MCP 호환 클라이언트와 Google API 사이의 다리 역할을 합니다. OAuth 2.0을 사용한 인증을 통해 AI가 호출할 수 있는 다양한 "도구"를 노출합니다. 이러한 도구는 문서를 마크다운 형식으로 읽기, 스프레드시트에 행 추가하기, 이메일 검색하기 등의 특정 API 작업에 대응합니다. npx를 통해 로컬에 배포하거나, 팀 전체가 사용 가능한 Google Cloud Run에서 원격으로 배포할 수 있습니다.

대상 사용자

개인 또는 전문적인 Google Workspace 데이터에 LLM이 직접 접근하여 자동화, 문서 초안 작성, 일정 관리 등을 수행하고자 하는 AI 코드 에디터 및 어시스턴트 사용자.

주요 특징

• 포괄적인 Workspace 통합: Google Docs, Sheets, Drive, Gmail, Calendar에 대한 완전한 CRUD 작업 지원.
• 마크다운 워크플로우: LLM 편집을 용이하게 하기 위해 마크다운 형식으로 문서 내용을 읽고 대체할 수 있음.
• 세부적인 시트 제어: 셀 서식 설정, 조건부 서식 설정, 테이블 생성, 범위 보호 등의 고급 스프레드시트 도구.
• Gmail 및 Calendar 자동화: 인바ックス 트리지, 이메일 발송, 드래프트 관리, Google Meet 링크 포함 일정 예약 등의 도구.
• Apps Script 지원: 더 깊은 자동화를 위한 백엔드 Apps Script 프로젝트 생성 및 편집 가능.
• 유연한 배포: 로컬 stdio 전송과 Cloud Run을 통한 원격 httpStream 배포 모두 지원.