Google Sheets MCP 서버

“Google Sheets” MCP 서버란?

Google Sheets MCP(Model Context Protocol) 서버는 TypeScript 기반 도구로, AI 어시스턴트가 Google Sheets에 안전하게 접근하여 명확하고 타입이 지정된 도구를 통해 상호작용할 수 있게 해줍니다. 이 서버는 AI 에이전트와 Google Sheets/Drive API 사이에서 다리 역할을 하며, 강력한 자동화와 데이터 조작 워크플로우를 구현할 수 있습니다. OAuth2와 서비스 계정 인증을 모두 지원하여 다양한 보안 요구에 유연하게 대응할 수 있습니다. 주요 역할은 개발자와 AI 워크플로우가 스프레드시트 생성, 셀 데이터 읽기/쓰기, 시트 및 탭 관리, 문서 공유 등 모든 작업을 프로그래밍적으로 안전하게 수행하도록 돕는 것입니다. 이 통합을 통해 Google Sheets 내에서 데이터베이스 스타일 쿼리, 공동 편집, 워크플로우 자동화가 가능해져 생산성과 AI 기반 개발 프로세스가 향상됩니다.

프롬프트 목록

저장소에 명시적인 프롬프트 템플릿은 문서화되어 있지 않습니다.

리소스 목록

저장소에 명시적인 리소스는 문서화되어 있지 않습니다.

도구 목록

• create
  새 스프레드시트를 만들고 선택적으로 지정한 Drive 폴더로 이동합니다.
• listSheets
  지정된 스프레드시트의 모든 시트 탭을 나열합니다.
• renameSheet
  기존 시트 탭의 이름을 변경합니다.
• createSheet
  스프레드시트에 새 시트 탭을 추가합니다.
• spreadsheetInfo
  스프레드시트의 메타데이터(제목, 시트 ID, 그리드 속성 등)를 가져옵니다.
• listSpreadsheets
  설정된 Drive 폴더 또는 내 드라이브의 모든 스프레드시트를 나열합니다.
• shareSpreadsheet
  사용자를 대상으로(읽기/댓글/쓰기 권한) 스프레드시트를 공유하고 알림을 보냅니다.
• sheetData
  시트 및 범위(또는 전체 시트)의 셀 값을 읽어옵니다.
• updateCells
  A1 형식 범위에 2차원 배열 값을 씁니다.
• batchUpdate
  여러 범위의 업데이트를 한 번에 적용합니다.
• addRows / addColumns
  지정한 인덱스에 행 또는 열을 삽입합니다.
• copySheet
  스프레드시트 간 시트 탭을 복사하며, 이름 변경도 가능합니다.

MCP 서버 활용 예시

• 스프레드시트 자동 생성 및 관리
  새 스프레드시트 생성, 시트/탭 추가·이름 변경, 파일 정리를 Google Drive 내에서 자동 워크플로우로 손쉽게 처리하세요.
• 데이터 추출 및 갱신
  대량 데이터의 읽기/쓰기를 Google Sheets에서 자동화하여 ETL 파이프라인, 리포팅, 대시보드 자동화에 적합합니다.
• 협업 접근 및 공유
  다양한 사용자와 자동으로 문서를 공유하고 권한을 설정하여 팀 협업과 자동 알림을 지원합니다.
• 대량 작업 및 데이터 조작
  일괄 업데이트, 여러 행/열 삽입 등 대형 시트 변경을 효율적으로 처리하여 반복 작업 시간을 절약할 수 있습니다.
• 시트 복제 및 조직화
  팀 단위의 대규모 작업을 위해 시트를 스프레드시트 간 복사(템플릿/백업/조직화)하세요.

설정 방법

Windsurf

1. Bun(v1.0 이상)이 설치되어 있고 Google Cloud 자격 증명(OAuth2 또는 서비스 계정)을 준비하세요.
2. 저장소를 클론하고 의존성을 설치하세요:
   git clone https://github.com/rohans2/mcp-google-sheets.git
cd mcp-google-sheets
bun install
3. 아래 예시처럼 환경 변수를 설정하세요.
4. Windsurf 설정 파일에 JSON 스니펫으로 MCP 서버를 추가하세요.
5. 설정을 저장하고 Windsurf를 재시작하세요.

예시 JSON 설정:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

환경 변수로 API 키 보호하기:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

Claude

1. 필수 프로그램을 설치하고 저장소를 클론하세요.
2. Google Cloud 인증 및 환경 변수를 설정하세요.
3. Claude의 MCP 설정 파일을 찾아 편집하세요.
4. 설정 스니펫을 사용해 Google Sheets MCP 서버를 추가하세요.
5. Claude를 재시작하고 연결을 확인하세요.

예시 JSON 설정:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cursor

1. Bun이 설치되어 있고 자격 증명이 설정되어 있는지 확인하세요.
2. 저장소를 다운로드하고 셋업하세요.
3. Cursor MCP 설정 파일을 편집하세요.
4. Google Sheets MCP 서버 항목을 추가하세요.
5. 변경 사항을 저장하고 Cursor를 재시작하여 서버를 활성화하세요.

예시 JSON 설정:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

Cline

1. Bun을 설치하고 Google Cloud 프로젝트 자격 증명을 설정하세요.
2. 저장소를 클론하고 모든 필수 의존성을 설치하세요.
3. Cline의 MCP 서버 설정에 접근해 편집하세요.
4. JSON 형식을 사용해 Google Sheets MCP 서버를 등록하세요.
5. 셋업을 적용하려면 Cline을 재시작하세요.

예시 JSON 설정:

{
  "mcpServers": {
    "google-sheets": {
      "command": "bun",
      "args": ["index.ts"]
    }
  }
}

환경 변수로 API 키 보호하기:

{
  "command": "bun",
  "args": ["index.ts"],
  "env": {
    "CREDENTIALS_CONFIG": "BASE64_ENCODED_CONFIG",
    "EMAIL_ID": "your-email@example.com"
  }
}

플로우 내에서 MCP 사용 방법

FlowHunt에서 MCP 사용하기

FlowHunt 워크플로우에 MCP 서버를 통합하려면, 먼저 플로우에 MCP 컴포넌트를 추가하고 이를 AI 에이전트와 연결하세요:

MCP 컴포넌트를 클릭하여 설정 패널을 엽니다. 시스템 MCP 설정 섹션에 아래와 같이 MCP 서버 정보를 JSON 형식으로 입력하세요:

{
  "google-sheets": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

설정이 완료되면, AI 에이전트가 MCP의 모든 기능과 도구를 활용할 수 있습니다. “google-sheets"는 실제 MCP 서버 이름으로, URL은 본인의 MCP 서버 주소로 변경하세요.

개요

의견

이 MCP 서버는 셋업 문서가 잘 갖춰져 있고 Google Sheets 자동화를 위한 강력한 도구 세트를 제공합니다. 다만, 명시적인 MCP 프롬프트 템플릿이나 리소스, 샘플링/roots 지원에 대한 언급이 없는 점은 아쉽습니다. 도구의 폭넓은 지원과 명확한 보안 가이드는 시트 자동화에 큰 장점이지만, 프롬프트/리소스 문서화와 샘플링/roots 지원 명확화가 추가된다면 더 완성도가 높아질 것입니다.

MCP 점수