Integrations

Integrates with Google Drive to list, access, and manage spreadsheets within shared folders, supporting both service account and OAuth authentication methods.
Enables creating, reading, updating, and managing Google Sheets spreadsheets, including operations like getting cell data, updating cells, creating spreadsheets, adding sheets, and manipulating rows and columns.

mcp-google-sheets: Google 시트 MCP 서버

이 MCP 서버는 Google Drive 및 Google Sheets와 통합되어 스프레드시트를 만들고 수정할 수 있습니다.

개요

Google 스프레드시트와 상호작용하기 위한 모델 컨텍스트 프로토콜 서버입니다. 이 서버는 Google 스프레드시트 API를 통해 스프레드시트를 만들고, 읽고, 업데이트하고, 관리할 수 있는 도구를 제공합니다.

도구

get_sheet_data
- Google 스프레드시트의 특정 시트에서 데이터 가져오기
- 입력:
  - spreadsheet_id (문자열): 스프레드시트의 ID(URL에서 찾음)
  - sheet (문자열): 시트의 이름
  - range (선택적 문자열): A1 표기법의 셀 범위(예: 'A1:C10')
- 반환: 시트 데이터의 2D 배열
update_cells
- Google 스프레드시트의 셀 업데이트
- 입력:
  - spreadsheet_id (문자열): 스프레드시트의 ID
  - sheet (문자열): 시트의 이름
  - range (문자열): A1 표기법의 셀 범위
  - data (2차원 배열): 업데이트할 값
- 반환: 업데이트 작업의 결과
batch_update_cells
- Google 스프레드시트에서 여러 범위 일괄 업데이트
- 입력:
  - spreadsheet_id (문자열): 스프레드시트의 ID
  - sheet (문자열): 시트의 이름
  - ranges (객체): 범위 문자열을 2차원 값 배열로 매핑하는 사전
- 반환: 일괄 업데이트 작업의 결과
list_sheets
- Google 스프레드시트의 모든 시트 나열
- 입력:
  - spreadsheet_id (문자열): 스프레드시트의 ID
- 반환: 시트 이름 목록
list_spreadsheets
- 구성된 Google Drive 폴더에 있는 모든 스프레드시트를 나열합니다.
- 반환: ID와 제목이 있는 스프레드시트 목록
- 참고: 서비스 계정 인증을 사용하는 경우 공유 폴더에 스프레드시트가 나열됩니다.
create_spreadsheet
- 새 Google 스프레드시트 만들기
- 입력:
  - title (문자열): 새 스프레드시트의 제목
- 반환: ID를 포함한 새로 생성된 스프레드시트에 대한 정보
- 참고: 구성된 폴더 ID로 서비스 계정 인증을 사용하는 경우 스프레드시트는 해당 폴더에 생성됩니다.
create_sheet
- 기존 Google 스프레드시트에 새 시트 탭 만들기
- 입력:
  - spreadsheet_id (문자열): 스프레드시트의 ID
  - title (문자열): 새 시트의 제목
- 반환: 새로 생성된 시트에 대한 정보
추가 도구: add_rows , add_columns , copy_sheet , rename_sheet

자원

spreadsheet://{spreadsheet_id}/info
- Google 스프레드시트에 대한 기본 정보 얻기
- 반환: 스프레드시트 정보가 포함된 JSON 문자열

설치 및 설정

서버를 실행하려면 Google Cloud Platform에서 설정을 해야 하며, 실행하기 전에 인증 방법을 선택해야 합니다.

Google Cloud Platform 설정(모든 방법에 필요)

Google Cloud Platform 프로젝트를 만듭니다.
- Google Cloud Console 로 이동
- 새 프로젝트를 만들거나 기존 프로젝트를 선택하세요
- Google 시트 API 및 Google 드라이브 API 활성화

인증 방법을 선택하세요

다음 두 가지 인증 방법 중 하나를 사용할 수 있습니다.

방법 1: 서비스 계정 인증(권장, 비대화형)

서비스 계정은 브라우저 프롬프트 없이 헤드리스 인증을 제공하므로 자동화 또는 서버 환경에 적합합니다. 이점은 다음과 같습니다.

인증에 브라우저 상호 작용이 필요하지 않습니다.
헤드리스 환경에서도 잘 작동합니다.
인증은 OAuth 토큰만큼 자주 만료되지 않습니다.
서버 배포 및 자동화에 적합

설정 단계:

서비스 계정을 만듭니다.
- Google Cloud Console → IAM 및 관리자 → 서비스 계정으로 이동합니다.
- 설명적인 이름으로 새 서비스 계정을 만듭니다.
- 적절한 역할(Google 시트 액세스)을 부여합니다.
- JSON 키 파일을 생성하고 다운로드합니다.
서비스 계정과 공유할 Google Drive에 전용 폴더를 만듭니다.
- Google Drive로 이동하여 새 폴더를 만듭니다(예: "Claude Sheets").
- URL에서 폴더 ID를 확인하세요: https://drive.google.com/drive/folders/FOLDER_ID_HERE
- 폴더를 마우스 오른쪽 버튼으로 클릭하고 "공유"를 선택하세요
- 서비스 계정 이메일 주소(JSON 파일에서 client_email 로 발견됨)와 공유합니다.
- "편집자" 액세스 권한을 부여하세요
다음 환경 변수를 설정하세요.
- SERVICE_ACCOUNT_PATH : 서비스 계정 JSON 키 파일 경로
- DRIVE_FOLDER_ID : 서비스 계정과 공유되는 Google Drive 폴더의 ID

방법 2: OAuth 2.0 인증(대화형)

이 방법은 처음 설정할 때 브라우저 상호 작용이 필요하므로 개인적인 용도나 개발에 적합합니다.

프로젝트에 OAuth를 구성하세요.
- OAuth 동의 화면 구성
- OAuth 2.0 클라이언트 ID 자격 증명 만들기(데스크톱 애플리케이션 유형)
- 자격 증명 JSON 파일을 다운로드하여 credentials.json 으로 저장합니다.
다음 환경 변수를 설정하세요.
- CREDENTIALS_PATH : 다운로드된 OAuth 자격 증명 파일의 경로(기본값: credentials.json )
- TOKEN_PATH : 인증 토큰이 저장될 경로(기본값: token.json )

환경 변수 설정

Linux/Mac의 경우:

지엑스피1

Windows의 경우:

# For service account authentication (recommended)
set SERVICE_ACCOUNT_PATH=C:\path\to\your\service-account-key.json
set DRIVE_FOLDER_ID=your_shared_folder_id_here

# OR for OAuth authentication
set CREDENTIALS_PATH=C:\path\to\your\credentials.json
set TOKEN_PATH=C:\path\to\your\token.json

서버 실행

방법 1: uvx 사용(일반적인 사용에 권장)

uvx 사용하면 설치 없이 서버를 직접 실행할 수 있습니다.

# Set environment variables first, then run the server
uvx mcp-google-sheets

방법 2: 개발 및 수정을 위해

서버를 수정하고 개발하고 싶다면:

저장소를 복제합니다.

git clone https://github.com/yourusername/mcp-google-sheets.git
cd mcp-google-sheets

uv로 실행:

# Set environment variables first, then run
uv run mcp-google-sheets

인증 프로세스

서버는 환경 변수에 따라 자동으로 인증 방법을 선택합니다.

먼저 서비스 계정 자격 증명(비대화형)을 확인합니다.
서비스 계정 인증이 실패하거나 구성되지 않으면 OAuth 흐름으로 돌아갑니다.

서비스 계정 인증을 사용하면 브라우저 상호 작용이 필요 없으며, 서버는 공유 Google Drive 폴더의 스프레드시트에서 직접 작업합니다.

OAuth 인증을 사용하면 서버를 처음 사용할 때 Google 계정으로 인증하기 위해 브라우저 창이 열립니다. 인증 후 토큰은 TOKEN_PATH 환경 변수에 지정된 위치에 저장됩니다.

Claude Desktop과 함께 사용

claude_desktop_config.json 에 다음을 추가하세요:

"mcpServers": {
  "google-sheets": {
    "command": "uvx",
    "args": ["mcp-google-sheets"],
    "env": {
      "SERVICE_ACCOUNT_PATH": "/path/to/your/service-account-key.json",
      "DRIVE_FOLDER_ID": "your_shared_folder_id_here"
    }
  }
}

"mcpServers": {
  "google-sheets": {
    "command": "uvx",
    "args": ["mcp-google-sheets"],
    "env": {
      "CREDENTIALS_PATH": "/path/to/your/credentials.json",
      "TOKEN_PATH": "/path/to/your/token.json"
    }
  }
}

"mcpServers": {
  "mcp-google-sheets": {
    "command": "uv",
    "args": [
      "--directory",
      "/path/to/mcp-google-sheets",
      "run",
      "mcp-google-sheets"
    ],
    "env": {
      "SERVICE_ACCOUNT_PATH": "/path/to/mcp-google-sheets/service-account-key.json",
      "DRIVE_FOLDER_ID": "your_shared_folder_id_here"
      // OR for OAuth: 
      // "CREDENTIALS_PATH": "/path/to/mcp-google-sheets/credentials.json",
      // "TOKEN_PATH": "/path/to/mcp-google-sheets/token.json"
    },
    "disabled": false
  }
}

클로드에 대한 예시 프롬프트

MCP 서버가 Claude에 연결되면 다음과 같은 프롬프트를 사용할 수 있습니다.

"내 공유 폴더에 있는 모든 스프레드시트 나열"
"2024년 예산"이라는 제목의 새 스프레드시트를 만드세요.
"ID가 1A2B3C4D5E6F7G8H인 스프레드시트의 Sheet1에서 데이터를 가져옵니다."
"내 스프레드시트의 Sheet2 시작 부분에 3개 행 추가"
"스프레드시트의 셀 A1:B2를 값 [[1, 2], [3, 4]]로 업데이트합니다."
"내 예산 스프레드시트의 모든 시트를 나열하세요"
"1분기 스프레드시트에서 '3월' 시트를 연간 스프레드시트로 복사하고 이름을 '1분기-3월'로 변경합니다."
"연간 예산 스프레드시트에 'Q4'라는 새 시트를 추가합니다."

특허

이 MCP 서버는 MIT 라이선스에 따라 라이선스가 부여됩니다. 즉, MIT 라이선스의 조건에 따라 소프트웨어를 자유롭게 사용, 수정 및 배포할 수 있습니다. 자세한 내용은 프로젝트 저장소의 LICENSE 파일을 참조하세요.

크레딧

이 프로젝트는 kazz187/mcp-google-spreadsheet 저장소에서 영감을 얻어 FastMCP를 사용하여 Python으로 이식되었습니다.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Google Drive 및 Google Sheets와 통합된 모델 컨텍스트 프로토콜 서버로, 사용자는 자연어 명령을 통해 스프레드시트를 만들고, 읽고, 업데이트하고, 관리할 수 있습니다.