MCP 구글 스위트

MCP Google Workspace 서버

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 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Google Workspace와 원활하게 통합되어 안전한 OAuth2 인증을 통해 Google Drive, Docs 및 Sheets 작업이 가능한 모델 컨텍스트 프로토콜 서버입니다.

Related MCP Servers

Nash MCP Server
nash-app
-
security
A
license
-
quality
A Model Context Protocol server that enables seamless execution of commands, Python code, web content fetching, and reusable task management with secure credentials handling.
Last updated -
2
Python
MIT License
Google Cloud MCP Server
krzko
-
security
F
license
-
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 -
16
2
TypeScript
MCP Google Map Server
cablate
A
security
A
license
A
quality
A Model Context Protocol server that provides Google Maps API integration, allowing users to search locations, get place details, geocode addresses, calculate distances, obtain directions, and retrieve elevation data through LLM processing capabilities.
Last updated -
7
163
25
TypeScript
MIT License
mcp-google-sheets
xing5
-
security
A
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 -
134
Python
MIT License

View all related MCP servers

MCP Google Suite