google-workspace-mcp
Provides comprehensive read/write access to Google Workspace files (Sheets, Docs, Slides, Forms) and Drive, enabling editing of existing files such as appending rows, modifying documents, and managing permissions, comments, and revisions.
README
google-workspace-mcp
Google Workspace(Sheets / Docs / Slides / Forms)와 Google Drive를 다루는 MCP 서버.
Cowork에 기본 연결된 공식 "Google Drive" 커넥터는 검색·읽기·파일 생성·휴지통 이동만 지원하고 기존 파일의 내용을 수정할 수 없다. 그래서 시트에 행 하나를 추가하려 해도 전체 데이터를 새 파일로 다시 만들어 기존 파일을 버리는 방식밖에 없었다. 이 서버는 그 공백을 메운다 — 파일 ID를 유지한 채 시트에 행을 덧붙이고, 문서 본문을 고치고, 슬라이드를 추가한다.
제공 도구
| 도구 | 하는 일 |
|---|---|
sheets_values |
셀 값 read / append(행 추가) / update / clear |
sheets_manage |
스프레드시트 생성, 탭 추가·삭제·이름변경, 메타데이터 조회, batchUpdate |
docs_read |
문서를 텍스트(표 포함) 또는 원본 구조로 읽기 |
docs_write |
문서 생성, 끝에 덧붙이기, 위치 삽입, 찾아 바꾸기, batchUpdate |
slides_read |
슬라이드별 텍스트·발표자노트 조회 |
slides_write |
프레젠테이션 생성, 슬라이드 추가(제목·본문 채우기), 삭제, 찾아 바꾸기 |
forms_tool |
설문 생성·조회, 응답 목록·단건 조회, batchUpdate |
drive_search |
파일명·내용 전문검색·MIME·폴더 조건 검색 |
drive_file |
메타데이터, 생성, 폴더 생성, 내용 교체(ID 유지), 이름변경, 이동, 복사, 휴지통, 완전삭제, 다운로드, export |
drive_comments |
댓글 조회·작성·답글·해결·삭제 |
drive_revisions |
버전 이력 조회, 과거 버전 내용 회수, 보존 고정 |
drive_permissions |
공유 권한 점검·추가·변경·해제 |
drive_shared_drives |
공유 드라이브 목록·상세 |
drive_changes |
시작 토큰 발급 후 그 이후 변경분만 조회 |
모든 도구는 max_chars로 응답 길이 상한을 조절할 수 있고, 0이면 자르지 않는다.
환경변수
| 이름 | 설명 |
|---|---|
GOOGLE_CLIENT_ID |
OAuth 클라이언트 ID |
GOOGLE_CLIENT_SECRET |
OAuth 클라이언트 시크릿 |
GOOGLE_REFRESH_TOKEN |
https://www.googleapis.com/auth/drive 스코프를 포함한 refresh token |
MCP_GATE_KEYS |
접근 게이트 허용 키 목록(쉼표 구분). 비어 있으면 게이트 비활성 |
MCP_GATE_MODE |
enforce면 키 없는 호출을 401로 차단 |
drive 스코프 하나로 Sheets·Docs·Slides·Forms API와 Drive API 전체가 커버된다
(각 API 공식 인증 스코프 목록에 auth/drive가 포함되어 있음).
Google Cloud 프로젝트 준비
스코프와 별개로, 사용할 API를 프로젝트에서 사용 설정(Enable) 해야 한다.
켜지 않으면 403 has not been used in project ... or it is disabled가 난다.
- Google Sheets API / Google Docs API / Google Slides API / Google Forms API
- Google Drive API
호출
https://<배포도메인>/api/mcp?k=<게이트키>
로컬 스모크테스트
scripts/.env.local.json(gitignore됨)에 위 Google 자격증명 3개를 넣고:
npm install
npm test
실제 Google 계정에 테스트 파일을 만들었다가 마지막에 휴지통으로 정리한다.
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.