google-suite-mcp

생각할 수 있는 AI를 가졌다면, 이제 손을 쥐어주세요.

Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI 및 기타 모든 Model Context Protocol 클라이언트에 Google 스프레드시트, 문서, 드라이브 및 Apps Script에 대한 전체 읽기/쓰기 제어 권한을 부여하는 오픈 소스 Google Workspace MCP 서버입니다. 82개의 도구, 하나의 서버, MIT 라이선스.

google-suite-mcp는 최초의 **워크스페이스 오퍼레이터(Workspace Operator)**입니다. Google Workspace를 AI가 조작할 수 있는 런타임으로 취급하는 유일한 MCP입니다. 단순히 Workspace를 읽기 전용 표면으로 노출하는 대신, 단일 호출로 대시보드를 구축하고, Apps Script를 배포하며, 문서를 서식 지정합니다.

10분 정도 소요되는 OAuth 설정이 전부입니다. 그 후에는 자연어 프롬프트 하나로 다중 셀 KPI 대시보드를 구축(sheets_build_dashboard)하거나, 스키마를 완전히 서식 지정된 시트로 변환(sheets_build_sheet)하거나, Google Apps Script를 라이브 웹 앱으로 게시(script_deploy)할 수 있습니다. 이는 우리가 본 다른 어떤 Google MCP에서도 제공하지 않는 세 가지 구성된 기본 요소입니다. 모든 도구는 검증되었습니다: 30개의 엔드투엔드 테스트 중 30개 모두 모의 테스트가 아닌 실제 Google API를 대상으로 통과했습니다. 도구가 여기에 나열되어 있다면, Google의 프로덕션 엔드포인트에 대해 실행되어 예상된 결과를 반환했다는 의미입니다.

MCP는 프로토콜이며 Claude 기능이 아닙니다. Model Context Protocol을 지원하는 모든 클라이언트는 어떤 모델을 사용하든 이 서버를 사용할 수 있습니다.

어디서부터 시작해야 할지 모르겠나요? 이 저장소 URL을 Claude Code, Claude Desktop, Cursor 또는 ChatGPT에 붙여넣고 설치 도움을 요청하세요. SETUP.md는 AI가 모든 단계를 안내하고, Google Cloud 링크를 열어주며, 마지막에 모든 것이 작동하는지 확인할 수 있도록 작성되었습니다.

60초 프롬프트로 할 수 있는 작업

이것들은 로드맵 항목이 아닌 실제 단일 프롬프트 결과입니다. 서버가 연결되면 MCP 클라이언트에 다음 중 하나를 붙여넣어 보세요.

• "Q4 시트에 매출, CAC, 이탈률, MRR이 포함된 KPI 대시보드를 만들고, 서식을 지정하고, 조건부 색상을 적용해 줘." → sheets_build_dashboard 호출 1회.

• "이 12개 열, 헤더 스타일, 데이터 유효성 검사, 첫 번째 행 고정이 포함된 'Clients'라는 새 시트를 만들어 줘." → sheets_build_sheet 호출 1회.

• "이 통합 문서의 모든 탭에서 'Q3 2025'를 찾아 'Q4 2025'로 모두 바꿔 줘." → sheets_find_replace_many 호출 1회.

• "이 시트에 연결된 Apps Script를 만들어 매주 월요일 오전 8시에 요약을 이메일로 보내게 하고, 웹 앱으로 배포해 줘." → script_deploy 호출 1회.

• "이 Google 문서에 이 행들을 포함한 5열짜리 가격표를 삽입해 줘." → docs_insert_table 호출 1회.

• "드라이브에 공유 폴더를 만들고, 이 세 파일을 그 안으로 이동시킨 뒤, 링크가 있는 모든 사람이 볼 수 있도록 권한을 설정해 줘."

• "마진이 15% 미만인 행을 빨간색으로 강조하는 조건부 서식을 추가해 줘."

• "H열의 수식을 보호해서 시트의 다른 사람이 편집하지 못하게 해 줘."

코드도, 수동 단계도, AI 클라이언트를 벗어나는 컨텍스트 전환도 필요 없습니다.

왜 또 다른 Google Workspace MCP 서버인가요?

GitHub에 있는 대부분의 Google MCP는 두 가지 범주 중 하나에 속합니다. 스프레드시트를 쿼리할 수는 있지만 변경할 수는 없는 읽기 전용 커넥터이거나, 문서, 드라이브, Apps Script를 완전히 무시하는 좁은 범위의 스프레드시트 전용 어댑터입니다. 이들은 커넥터입니다. REST API를 감싼 얇은 래퍼에 불과하며, AI는 작업을 완료하기 위해 40번의 도구 호출과 엄청난 토큰 비용을 지불해야 합니다.

google-suite-mcp는 커넥터가 아닙니다. 오퍼레이터입니다. 기본 요소는 엔드포인트(범위 읽기, 셀 쓰기, 파일 나열)가 아니라 결과(대시보드 구축, 스크립트 배포, 보고서 서식 지정)입니다. 실제 작업은 도구를 넘나들기 때문에 오퍼레이터는 전체 제품군을 다룹니다. 실제 작업은 단일 셀 편집으로 끝나지 않기 때문에 오퍼레이터는 구성된 기본 요소를 제공합니다.

그들은 zig를 할 때, 우리는 zag를 합니다.

기능 비교

요구 사항

• Node.js 20 이상

• Google 계정 (AI가 접근하길 원하는 Workspace 파일에 대한 액세스 권한 필요)

• Google Cloud 프로젝트 (무료 티어 가능)

• OAuth 2.0 데스크톱 자격 증명

• MCP 호환 클라이언트: Claude Desktop, Cursor, Windsurf, Zed, VS Code (GitHub Copilot), Gemini CLI, Cline, Goose, OpenAI Agents SDK 기반 에이전트 또는 MCP를 지원하는 모든 클라이언트

Google Cloud를 처음 사용하신다면 초기 설정에 약 10분 정도 예상하세요. 한 번만 하면 다시 할 필요 없습니다.

google-suite-mcp 설치 방법

npm install -g google-suite-mcp

또는 전역 설치를 건너뛰고 MCP 클라이언트가 npx -y google-suite-mcp를 통해 필요할 때 가져오도록 할 수 있습니다(아래 클라이언트 구성 블록 참조).

어느 쪽이든 서버는 자격 증명과 OAuth 토큰을 ~/.google-suite-mcp/에 저장합니다. 도구를 처음 실행하면 Google Cloud OAuth 클라이언트 JSON을 어디에 넣어야 하는지 정확히 알려주고 동의를 위해 브라우저를 엽니다. 일회성 Google Cloud 단계는 SETUP.md를 참조하세요.

Google Workspace 연결 방법

이것은 설정 중 유일하게 주의가 필요한 부분입니다. 아래의 모든 링크는 다음 클릭이 필요한 정확한 Google Cloud Console 페이지를 엽니다. 따라서 무엇을 찾을 필요가 없습니다.

전체 가이드: SETUP.md에는 주요 오류에 대한 문제 해결과 함께 모든 단계가 순서대로 나와 있습니다. 요약하자면:

1. Google Cloud 프로젝트 생성 (10초, 무료 티어)

2. 4개의 API 활성화 (각 링크를 클릭하고 '사용'을 누르세요):

   • Sheets API

   • Docs API

   • Drive API

   • Apps Script API

3. OAuth 동의 화면 구성: '외부'를 선택하고 본인의 Google 이메일을 테스트 사용자로 추가하세요.

4. OAuth 2.0 데스크톱 클라이언트 생성: 자격 증명 만들기 > OAuth 클라이언트 ID > 데스크톱 앱. 클라이언트 ID와 클라이언트 보안 비밀번호를 복사하세요.

5. .env에 자격 증명 붙여넣기:

   cp .env.example .env

   그런 다음 .env를 편집하고 4단계에서 얻은 클라이언트 ID와 보안 비밀번호를 붙여넣으세요.

서버가 도구를 처음 실행할 때 브라우저를 열어 Google의 동의 절차를 안내하고 새로 고침 토큰을 로컬에 캐시합니다. 액세스 권한을 취소하지 않는 한 다시 인증할 필요가 없습니다.

어떤 단계에서든 막히면 SETUP.md를 AI 어시스턴트에 붙여넣고 한 단계씩 안내해 달라고 요청하세요.

MCP 클라이언트 연결 방법

모든 MCP 호환 클라이언트는 동일한 두 가지를 허용합니다: 실행할 command와 args 목록. 아래 블록은 npx를 사용하므로 로컬 설치 경로를 관리할 필요가 없습니다.

Claude Desktop

구성 파일을 엽니다:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

이 항목을 추가하세요:

{
  "mcpServers": {
    "google-suite": {
      "command": "npx",
      "args": ["-y", "google-suite-mcp"]
    }
  }
}

Claude Desktop을 다시 시작하세요. 도구 선택기에 82개의 도구가 나타납니다.

Cursor, Windsurf, Zed, VS Code

각 클라이언트는 고유한 MCP 구성 위치를 가지고 있지만 동일한 command 및 args 형태를 허용합니다. 클라이언트의 MCP 문서를 참조하고 위 블록을 MCP 서버 섹션 아래에 붙여넣으세요. 다른 변경 사항은 필요하지 않습니다.

Gemini CLI

동일한 command 및 args를 사용하여 Gemini CLI MCP 구성(~/.gemini/config.json 또는 동등한 파일)에 서버를 추가하세요.

OpenAI Agents SDK

OpenAI Agents SDK(Python 및 TypeScript)는 MCP 서버를 기본적으로 지원합니다. 에이전트를 구성할 때 MCP 서버로 google-suite-mcp를 전달하면 선택한 모든 OpenAI 모델에서 82개의 도구를 사용할 수 있습니다.

기타 MCP 클라이언트

Model Context Protocol을 지원한다면 작동합니다. 클라이언트가 MCP 서버를 정의하는 곳 어디에서나 동일한 command 및 args 패턴을 사용하세요.

사용 예시

서버가 연결되면 항상 하던 대로 AI와 대화하세요. 이제 AI에게 손이 생겼습니다.

스키마에서 라이브 KPI 대시보드 구축

"'Q4 Forecast'라는 통합 문서에서 'Dashboard'라는 새 탭을 만들고 매출, 매출 총이익, CAC, 이탈률이라는 4개의 셀로 KPI 대시보드를 구축해 줘. 'Raw' 탭에서 값을 가져오고, 헤더는 굵게, 숫자는 통화 형식으로 지정하고, 목표치 미만인 항목은 빨간색으로 강조해 줘."

sheets_build_dashboard 호출 1회. 완료.

스키마를 시트로 변환

"이름, 이메일, 상태(드롭다운: Lead / Active / Churned), 마지막 연락일(날짜), 메모 열이 있는 'Client Tracker'라는 새 시트를 만들어 줘. Churned 행이 빨간색으로 변하도록 조건부 서식을 추가해 줘."

sheets_build_sheet 호출 1회. 완료.

실제 구조를 갖춘 문서 작성

"Docs에서 Henderson 프로젝트를 위한 킥오프 브리핑 초안을 작성해 줘. 이해관계자 표, 타임라인 표, 불렛 포인트가 있는 위험 섹션을 포함해 줘."

docs_insert_table은 ASCII 모방이 아닌 실제 표를 제공합니다.

Apps Script 웹 앱 배포

"이 시트에 연결된 새 Apps Script 프로젝트를 만들고, Summary 탭을 JSON으로 반환하는 doGet을 추가하고, 버전을 지정한 뒤 curl로 호출할 수 있는 웹 앱으로 배포해 줘."

script_deploy가 게시합니다. 라이브 URL을 얻게 됩니다.

통합 문서의 모든 시트에서 필드 이름 바꾸기

"Expenses 통합 문서에서 모든 시트에 걸쳐 'customer_id'가 나타나는 모든 곳을 한 번에 'account_id'로 바꿔 줘."

sheets_find_replace_many가 한 번의 호출로 처리합니다.

드라이브 정리

"'2026 Client Intake'라는 폴더를 만들고, 내 드라이브에서 이름에 'intake'가 포함된 모든 파일을 그 안으로 이동시킨 뒤, 링크가 있는 모든 사람이 볼 수 있도록 폴더를 공유해 줘."

도구 목록 요약 (82개 도구)

Google 표면별 그룹화:

• Google 스프레드시트 (53개 도구). 생성, 나열, 읽기, 쓰기, 추가, 서식 지정, 조건부 서식, 차트, 명명된 범위, 보호된 범위, 필터, 정렬, 유효성 검사, 테두리, 병합, 창 고정, 크기 조정, 찾기/바꾸기(단일 및 모든 탭에 걸친 sheets_find_replace_many), 검색, 수식, 배열 수식, 일괄 업데이트, 복제, 이름 바꾸기, 순서 변경, 삭제, sheets_build_sheet, sheets_build_dashboard.

• Google 문서 (8개 도구). 생성, 쓰기, 텍스트 서식 지정, 텍스트 가져오기, 텍스트 바꾸기, 이미지 삽입, docs_insert_table, 내보내기.

• Google 드라이브 (12개 도구). 업로드, 다운로드, 검색, 정보 가져오기, 이동, 복사, 이름 바꾸기, 휴지통, 폴더 생성, 공유, 권한 나열 및 업데이트.

• Google Apps Script (7개 도구). 생성, 업데이트, 가져오기, 바인딩된 스크립트 가져오기, 실행, 버전 생성, script_deploy.

• 인증 (2개 도구).