Google Docs, Sheets, Drive, Gmail 및 Calendar MCP 서버

정의 – Google Workspace API(Docs, Sheets, Drive, Gmail, Calendar, Apps Script)를 Claude Desktop, Cursor 또는 MCP 호환 클라이언트와 같은 AI 에이전트가 호출할 수 있는 도구로 노출하는 Node 기반 MCP(멀티 클라이언트 프로토콜) 서버입니다.

작동 방식 –

1. Google Cloud OAuth 클라이언트를 만들고 필요한 Workspace API를 활성화합니다.
2. npx @a-bonus/google-docs-mcp auth를 실행하여 로컬에 저장된 새로 고침 토큰을 얻습니다.
3. MCP 클라이언트 구성에 서버 정의를 추가합니다. 클라이언트는 필요에 따라 서버를 시작합니다(또는 공유 원격 엔드포인트를 위해 Cloud Run에 배포할 수 있습니다).
4. 서버는 MCP 호출을 Google API 요청으로 변환하고 구조화된 JSON 결과를 반환합니다.

주요 기능 –

• Docs: 일반 텍스트, 마크다운, 표, 이미지, 스타일, 댓글, 탭, 섹션 등의 읽기/쓰기.
• Sheets: 범위 읽기/쓰기, 일괄 업데이트, 서식, 표, 차트, 조건부 서식, 보호, 드롭다운 등.
• Drive: 파일/폴더 나열, 검색, 생성, 이동, 복사, 이름 변경, 삭제, 콘텐츠 다운로드.
• Gmail: 메시지 나열/검색, 전체 본문 읽기, 보내기/답장, 초안, 라벨, 휴지통 관리, 복합 triageInbox 헬퍼.
• Calendar: 이벤트 나열/검색, 생성/업데이트/삭제, 자연어 빠른 추가.
• Apps Script: 바인딩 또는 독립 실행형 스크립트 프로젝트 생성, 읽기, 업데이트.

일반적인 사용 사례 – LLM 기반 어시스턴트가 "문서 ABC123에 '회의 메모' 추가" 또는 "시트 XYZ789에 '작업'이라는 표 만들기"와 같은 자연어 명령을 발행하면 MCP 클라이언트가 이 서버로 전달하고, 서버가 적절한 Google API를 호출하여 결과를 반환합니다.

배포 옵션 –

• 로컬: 개발자 머신에서 npx를 통해 실행. 토큰은 ~/.config/google-docs-mcp/token.json에 저장됩니다.
• 원격: 컨테이너를 Google Cloud Run(또는 모든 컨테이너 호스트)에 배포합니다. 서버는 MCP OAuth 2.1을 사용하므로 클라이언트가 Google 로그인을 자동으로 처리합니다. 로컬 토큰이 필요 없습니다.

설정 하이라이트 –

• Google Cloud에서 Docs, Sheets, Drive, Gmail, Calendar 및 Apps Script API를 활성화합니다.
• GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET을 제공합니다(원격 모드에서는 선택적으로 TOKEN_STORE=firestore, JWT_SIGNING_KEY).
• 제공된 JSON 스니펫을 사용하여 서버를 MCP 클라이언트 구성에 추가합니다.

중요성 – 강력한 LLM 에이전트와 전체 Google Workspace 제품군을 연결하여 AI 어시스턴트가 매번 사용자 지정 OAuth 코드를 작성하지 않고도 문서, 스프레드시트, 이메일 및 캘린더를 프로그래밍 방식으로 읽고, 편집하고, 조정할 수 있게 합니다.

---

빠른 시작

# 1. 인증
GOOGLE_CLIENT_ID=… GOOGLE_CLIENT_SECRET=… npx -y @a-bonus/google-docs-mcp auth

# 2. 클라이언트에 추가(Claude Desktop / Cursor)
{
  "mcpServers": {"google-docs": {"command": "npx","args": ["-y","@a-bonus/google-docs-mcp"],"env": {"GOOGLE_CLIENT_ID":"…","GOOGLE_CLIENT_SECRET":"…"}}}
}

원격 배포 예시

gcloud run deploy google-docs-mcp \
  --source . \
  --region europe-west3 \
  --port 8080 \
  --allow-unauthenticated \
  --set-env-vars "MCP_TRANSPORT=httpStream,BASE_URL=https://your-service.run.app,GOOGLE_CLIENT_ID=…,GOOGLE_CLIENT_SECRET=…,TOKEN_STORE=firestore,JWT_SIGNING_KEY=your-secret-key"

---

모든 세부 사항은 저장소의 README에서 직접 가져온 것입니다.