aaronsb/google-workspace-mcp

Developer tools

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

192 stars 59 forks 품질 85 트렌드 37Apache-2.0

Repository Install

aaronsb/google-workspace-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요

aaronsb/google-workspace-mcp는 [[T0]에서 가져온 MCP 서버 후보입니다.

개요(AI 번역)

**AI 에이전트에게 Google Workspace에 실제 접근 권한을 주세요 — Gmail, 캘린더, 드라이브, 문서, 시트, 작업, 미팅, 연락처 — 하나의 MCP 서버에서, 보유한 계정만큼 많아요.

메일을 검색하고, 달력을 확인하고, 문서를 작성하고, 업무를 제출하세요 — 대화 속에서, 자신으로서.

설치

먼저, Google OAuth 자격 증명이 필요합니다 — 모든 경로에 공통적으로 필요한 전제 조건입니다:

console.cloud.google.com/apis/credentials 로 가세요
OAuth 2.0 클라이언트 ID, 애플리케이션 유형 데스크톱 앱 생성
원하는 API(Gmail, 캘린더, 드라이브, 시트, 문서, 작업, 미팅 — 그리고 구글이 콘솔에서 연락처라고 부르는 People API’)를 활성화하세요.
클라이언트 ID와 클라이언트 비밀을 항상 준비해 두세요 — 아래에 붙여넣으세요

그리고 본인이 일하는 방식에 맞는 경로를 선택하세요. 세 곳 모두 같은 서버를 운영합니다.

노드 22.12 또는 그 이후. (노드 18과 20은 모두 수명이 종료되었습니다.)

📦 → 🤖 클로드 데스크톱 — 원클릭 `.mcpb` 설치 (권장)

최신 버전에서 **google-workspace-mcp.mcpb**를 다운로드한 후, **Claude 데스크톱 창으로 드래그하거나 더블 클릭하세요.

Claude Desktop은 세 가지 필드로 설치된 설치 대화상자를 엽니다:

필드

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

README

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

Google Workspace MCP Server

Give your AI agent real access to Google Workspace — Gmail, Calendar, Drive, Docs, Sheets, Tasks, Meet and Contacts — from one MCP server, across as many accounts as you have.

Search your mail, check your calendar, write a doc, file a task — in conversation, as yourself.

Install

First, you need Google OAuth credentials — the one prerequisite common to every path:

Go to console.cloud.google.com/apis/credentials
Create an OAuth 2.0 Client ID, application type Desktop app
Enable the APIs you want (Gmail, Calendar, Drive, Sheets, Docs, Tasks, Meet — and People API for contacts, which is what Google calls it in the console)
Keep the Client ID and Client Secret handy — you’ll paste them in below

Then pick the path that matches how you work. All three run the same server.

Node 22.12 or newer. (Node 18 and 20 are both end-of-life.)

📦 → 🤖 Claude Desktop — one-click `.mcpb` install (recommended)

Download google-workspace-mcp.mcpb from the latest release, then drag it onto the Claude Desktop window, or double-click it.

Claude Desktop opens an install dialog with three fields:

Field
Google OAuth Client ID	required — from the step above
Google OAuth Client Secret	required — from the step above
Workspace Directory	optional — where attachments, downloads and exports land. Defaults to `~/.local/share/google-workspace-mcp/workspace/`. Give it a dedicated folder — not your home, Documents, Desktop, or a Google Drive folder.

Paste, hit Save, done. No JSON to edit, no Node to install, no paths to get right — the bundle carries the server and every dependency.

One bundle covers every platform — macOS (Intel and Apple Silicon), Linux (x64 and ARM64), and Windows. There is nothing to choose: the server is pure JavaScript, so there is no platform-specific payload to pick between.

GitHub에서 전체 README 보기

설치

npx -y @aaronsb/google-workspace-mcp

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "google-workspace": {
      "command": "npx",
      "args": ["-y", "@aaronsb/google-workspace-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}