MCP Google Workspace 서버

씨아이 코드코브 PyPI 버전 라이센스: MIT 코드 스타일: 검정색

AI 에이전트가 Google Workspace(Drive, Docs, Sheets) 서비스와 상호 작용할 수 있도록 하는 MCP(Model Context Protocol) 서버입니다.

🌟 특징

Google 드라이브: 파일 검색, 폴더 생성
Google 문서: 문서 만들기, 읽기, 업데이트
Google 시트: 스프레드시트 만들기, 셀 값 읽기/쓰기
다양한 전송 모드: stdio(기본값), SSE, WebSocket
MCP 호환 클라이언트 지원(커서 등)

📋 설치

uv 사용(권장)

지엑스피1

pip 사용하기

pip install mcp-google-suite

개발 설정

# Clone and install git clone git@github.com:adexltd/mcp-google-suite.git && cd mcp-google-suite uv venv && source .venv/bin/activate # or .venv\Scripts\activate on Windows uv pip install -e .

🔧 구성

MCP 클라이언트에 대한 구성

클라이언트 설정(예: 커서, 클로드)에 다음을 추가합니다.

uvx 사용(권장):

{ "mcpServers": { "mcp-google-suite": { "command": "uvx", "args": ["mcp-google-suite"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json", "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json" } } } }

pip 설치 사용:

{ "mcpServers": { "mcp-google-suite": { "command": "python", "args": ["-m", "mcp_google_suite"], "env": { "GOOGLE_APPLICATION_CREDENTIALS": "~/.google/server-creds.json", "GOOGLE_OAUTH_CREDENTIALS": "~/.google/oauth.keys.json" } } } }

Google OAuth 설정

Google Cloud Console 방문
Drive, Docs 및 Sheets API 사용 설정
OAuth 2.0 자격 증명 만들기
~/.google/oauth.keys.json 으로 저장
mcp-google auth 실행하여 인증하세요.

사용 가능한 도구

드라이브 운영

drive_search_files : Google Drive에서 파일 검색
- query (문자열, 필수): 검색 쿼리
- page_size (정수, 선택 사항): 반환할 결과 수
drive_create_folder : 새 폴더 만들기
- name (문자열, 필수): 폴더 이름
- parent_id (문자열, 선택 사항): 상위 폴더 ID

문서 작업

docs_create : 새 문서를 만듭니다
- title (문자열, 필수): 문서 제목
- content (문자열, 선택 사항): 초기 콘텐츠
docs_get_content : 문서 내용 가져오기
- document_id (문자열, 필수): 문서 ID
docs_update_content : 문서 내용 업데이트
- document_id (문자열, 필수): 문서 ID
- content (문자열, 필수): 새 콘텐츠

시트 작업

sheets_create : 새 스프레드시트를 만듭니다
- title (문자열, 필수): 스프레드시트 제목
- sheets (배열, 선택 사항): 시트 이름
sheets_get_values : 셀 값 가져오기
- spreadsheet_id (문자열, 필수): 스프레드시트 ID
- range (문자열, 필수): A1 표기법 범위
sheets_update_values : 셀 값 업데이트
- spreadsheet_id (문자열, 필수): 스프레드시트 ID
- range (문자열, 필수): A1 표기법 범위
- values (배열, 필수): 값의 2차원 배열

🛠️ 개발

# Install dev dependencies uv pip install -e ".[dev]" # Setup pre-commit hooks pre-commit install # Run tests pytest # Format code black . && ruff check --fix .

🔍 디버깅

대화형 테스트를 위해 MCP Inspector를 사용하세요.

# Using uvx npx @modelcontextprotocol/inspector uvx mcp-google # For development cd path/to/mcp-google-suite npx @modelcontextprotocol/inspector uv run mcp-google

📚 리소스

🤝 기여하기

행동 강령과 풀 리퀘스트 제출 프로세스에 대한 자세한 내용은 CONTRIBUTING.md를 읽어보세요.

🔒 보안

취약점 보고 및 모범 사례는 SECURITY.md를 참조하세요.

📄 라이센스

MIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

Deploy Server

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

Related Resources

GitHub Repository

Need Help?

Report Issue

Reddit Discussion about this server

Tools

Related MCP Servers

Google Cloud MCP Server
krzko
A
security
-
license
A
quality
A Model Context Protocol server that connects to Google Cloud services, allowing users to query logs, interact with Spanner databases, and analyze Cloud Monitoring metrics through natural language interaction.
Last updated -
40
55
62
Apache 2.0
mcp-google-sheets
xing5
-
security
-
license
-
quality
A Model Context Protocol server that integrates with Google Drive and Google Sheets, enabling users to create, read, update, and manage spreadsheets through natural language commands.
Last updated -
494
MIT License
MCP Google Workspace Server
josedu90
A
security
-
license
A
quality
A Model Context Protocol server that enables AI agents to interact with Google Workspace services including Drive, Docs, and Sheets through natural language commands.
Last updated -
8
MIT License
Google Docs MCP Server
penysho
A
security
-
license
A
quality
A Model Context Protocol server that provides an interface for AI models to interact with Google Docs, enabling reading, creating, updating, and searching Google Documents.
Last updated -
4
3

View all related MCP servers

MCP Google Suite