Google Sheets API 통합을 위한 모델 컨텍스트 프로토콜(MCP) 서버입니다. MCP 클라이언트(예: Claude Code, Claude Desktop, Cursor 등)에서 Google Sheets 문서를 직접 읽고, 쓰고, 관리할 수 있게 합니다.

주요 특징

• 완전한 Google 시트 통합: 스프레드시트 읽기, 쓰기 및 관리
• 고급 연산: 배치 연산, 서식, 차트, 조건부 서식
• 유연한 인증: 파일 기반 및 JSON 문자열 자격 증명 모두 지원
• Production Ready: TypeScript, 포괄적인 오류 처리, 완전한 테스트 커버리지로 구축됨

요구 사항

• Node.js v20 이상
• Sheets API 활성화된 구글 클라우드 프로젝트
• JSON 키 파일이 있는 서비스 계정
• NPM

시작하기

빠른 설치 (권장)

MCP 클라이언트에 다음 설정을 추가하세요:

[! 참고] mcp-gsheets@latest를 사용하면 MCP 클라이언트가 항상 최신 버전의 MCP Google Sheets 서버를 사용하도록 보장합니다.

MCP 클라이언트 구성

클로드 코드 Claude 코드 CLI를 사용해 MCP Google Sheets 서버를 추가하세요 (가이드):

추가한 후에는 Claude Code 설정을 수정하여 필요한 환경 변수를 추가하세요:

Claude Desktop

MCP Google Sheets Server

A Model Context Protocol (MCP) server for Google Sheets API integration. Enables reading, writing, and managing Google Sheets documents directly from your MCP client (e.g., Claude Code, Claude Desktop, Cursor, etc.).

Key Features

• Complete Google Sheets Integration: Read, write, and manage spreadsheets
• Advanced Operations: Batch operations, formatting, charts, and conditional formatting
• Flexible Authentication: Support for both file-based and JSON string credentials
• Production Ready: Built with TypeScript, comprehensive error handling, and full test coverage

Requirements

• Node.js v22 or higher
• Google Cloud Project with Sheets API enabled
• Service Account with JSON key file
• npm

Getting Started

Quick Install (Recommended)

Add the following config to your MCP client:

{
  "mcpServers": {
    "mcp-gsheets": {
      "command": "npx",
      "args": ["-y", "mcp-gsheets@latest"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/absolute/path/to/service-account-key.json"
      }
    }
  }
}

[!NOTE] Using mcp-gsheets@latest ensures that your MCP client will always use the latest version of the MCP Google Sheets server.

MCP Client Configuration

Add to your Claude Desktop config: