MCP Reference: sheetsmcp.googleapis.com

Google Sheets와 상호작용하는 도구를 제공하는 MCP 서버입니다.

모델 컨텍스트 프로토콜 (MCP) 서버는 대규모 언어 모델 (LLM) 또는 AI 애플리케이션에 컨텍스트, 데이터 또는 기능을 제공하는 외부 서비스 간의 프록시 역할을 합니다. MCP 서버는 AI 애플리케이션을 데이터베이스 및 웹 서비스와 같은 외부 시스템에 연결하여 AI 애플리케이션이 이해할 수 있는 형식으로 응답을 변환합니다.

MCP 도구

MCP 도구는 MCP 서버가 LLM 또는 AI 애플리케이션에 노출하여 현실 세계에서 작업을 실행하는 함수 또는 실행 가능한 기능입니다.

도구

sheetsmcp.googleapis.com MCP 서버에는 다음 도구가 있습니다.

MCP 도구
get_values 스프레드시트에서 값의 범위를 반환합니다. REST API의 spreadsheets.values.get에 해당합니다(https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/get).
get_spreadsheet 지정된 스프레드시트의 스프레드시트 콘텐츠를 반환합니다. 지정된 스프레드시트 ID의 제목, 시트 이름, 그리드 속성, 기타 메타데이터를 반환합니다. 요청된 경우 전체 그리드 데이터도 반환합니다. REST API의 spreadsheets.get에 해당합니다(https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/get).
update_spreadsheet

스프레드시트에 하나 이상의 업데이트를 적용합니다.

REST API의 spreadsheets.batchUpdate에 해당합니다(https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate).

가능한 업데이트 목록은 다음과 같습니다.

  • updateSpreadsheetProperties: 스프레드시트의 속성을 업데이트합니다.
  • updateSheetProperties: 시트의 속성을 업데이트합니다.
  • updateDimensionProperties: 측정기준의 속성을 업데이트합니다.
  • updateNamedRange: 이름이 지정된 범위를 업데이트합니다.
  • repeatCell: 범위에 걸쳐 단일 셀을 반복합니다.
  • addNamedRange: 이름이 지정된 범위를 추가합니다.
  • deleteNamedRange: 이름이 지정된 범위를 삭제합니다.
  • addSheet: 시트를 추가합니다.
  • deleteSheet: 시트를 삭제합니다.
  • autoFill: 기존 데이터를 기반으로 더 많은 데이터를 자동으로 입력합니다.
  • cutPaste: 한 영역에서 데이터를 잘라 다른 영역에 붙여넣습니다.
  • copyPaste: 한 영역에서 데이터를 복사하여 다른 영역에 붙여넣습니다.
  • mergeCells: 셀을 병합합니다.
  • unmergeCells: 병합된 셀을 병합 취소합니다.
  • updateBorders: 셀 범위의 테두리를 업데이트합니다.
  • updateCells: 여러 셀을 한 번에 업데이트합니다.
  • addFilterView: 필터 보기를 추가합니다.
  • appendCells: 시트에서 데이터가 있는 마지막 행 뒤에 셀을 추가합니다.
  • clearBasicFilter: 시트의 기본 필터를 지웁니다.
  • deleteDimension: 시트에서 행 또는 열을 삭제합니다.
  • deleteEmbeddedObject: 시트에서 삽입된 객체 (예: 차트, 이미지)를 삭제합니다.
  • deleteFilterView: 시트에서 필터 보기를 삭제합니다.
  • duplicateFilterView: 필터 보기를 복제합니다.
  • duplicateSheet: 시트를 복제합니다.
  • findReplace: 일부 텍스트를 찾아 다른 텍스트로 바꿉니다.
  • insertDimension: 시트에 새 행 또는 열을 삽입합니다.
  • insertRange: 시트에 새 셀을 삽입하여 기존 셀을 이동합니다.
  • moveDimension: 행 또는 열을 시트의 다른 위치로 이동합니다.
  • updateEmbeddedObjectPosition: 삽입된 객체 (예: 차트, 이미지)의 위치를 업데이트합니다.
  • pasteData: 데이터를 시트에 붙여넣습니다 (HTML 또는 구분됨).
  • textToColumns: 텍스트 열을 여러 텍스트 열로 변환합니다.
  • updateFilterView: 필터 보기의 속성을 업데이트합니다.
  • deleteRange: 시트에서 셀 범위를 삭제하고 나머지 셀을 이동합니다.
  • appendDimension: 시트 끝에 측정기준을 추가합니다.
  • addConditionalFormatRule: 새 조건부 서식 규칙을 추가합니다.
  • updateConditionalFormatRule: 기존 조건부 서식 규칙을 업데이트합니다.
  • deleteConditionalFormatRule: 기존 조건부 서식 규칙을 삭제합니다.
  • sortRange: 범위의 데이터를 정렬합니다.
  • setDataValidation: 하나 이상의 셀에 데이터 유효성 검사를 설정합니다.
  • setBasicFilter: 시트에 기본 필터를 설정합니다.
  • addProtectedRange: 보호된 범위를 추가합니다.
  • updateProtectedRange: 보호된 범위를 업데이트합니다.
  • deleteProtectedRange: 보호된 범위를 삭제합니다.
  • autoResizeDimensions: 해당 측정기준의 셀 콘텐츠를 기반으로 하나 이상의 측정기준의 크기를 자동으로 조절합니다.
  • addChart: 차트를 추가합니다.
  • updateChartSpec: 차트 사양을 업데이트합니다.
  • updateBanding: 범위가 지정된 범위를 업데이트합니다.
  • addBanding: 새로운 구간 범위를 추가합니다.
  • deleteBanding: 밴드 범위 삭제
  • createDeveloperMetadata: 새 개발자 메타데이터를 만듭니다.
  • updateDeveloperMetadata: 기존 개발자 메타데이터 항목을 업데이트합니다.
  • deleteDeveloperMetadata: 개발자 메타데이터를 삭제합니다.
  • randomizeRange: 범위의 행 순서를 무작위로 지정합니다.
  • addDimensionGroup: 지정된 범위에 그룹을 만듭니다.
  • deleteDimensionGroup: 지정된 범위의 그룹을 삭제합니다.
  • updateDimensionGroup: 지정된 그룹의 상태를 업데이트합니다.
  • trimWhitespace: 공백 (예: 스페이스, 탭, 줄바꿈)이 있는 셀을 자릅니다.
  • deleteDuplicates: 셀 범위의 지정된 열에 중복 값이 포함된 행을 삭제합니다.
  • updateEmbeddedObjectBorder: 삽입된 객체의 테두리를 업데이트합니다.
  • addSlicer: 슬라이서를 추가합니다.
  • updateSlicerSpec: 슬라이서의 사양을 업데이트합니다.
  • addDataSource: 데이터 소스를 추가합니다.
  • updateDataSource: 데이터 소스를 업데이트합니다.
  • deleteDataSource: 데이터 소스를 삭제합니다.
  • refreshDataSource: 하나 이상의 데이터 소스와 연결된 dbobject를 새로고침합니다.
  • cancelDataSourceRefresh: 하나 이상의 데이터 소스 및 연결된 dbobject의 새로고침을 취소합니다.
  • addTable: 테이블을 추가합니다.
  • updateTable: 테이블을 업데이트합니다.
  • deleteTable: 테이블 삭제 요청입니다.
update_values 스프레드시트의 범위에 값을 설정합니다. REST API의 spreadsheets.values.update에 해당합니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
update_formulas 스프레드시트의 범위에 공식을 설정합니다. REST API의 spreadsheets.values.update에 해당합니다. https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets.values/update
insert_dimension 시트의 특정 색인에 행 또는 열을 삽입합니다. 스프레드시트의 InsertDimensionRequest에 해당합니다(스프레드시트.batchUpdate REST API: https://developers.google.com/workspace/sheets/api/reference/rest/v4/spreadsheets/request).

MCP 도구 사양 가져오기

MCP 서버의 모든 도구에 대한 MCP 도구 사양을 가져오려면 tools/list 메서드를 사용하세요. 다음 예시에서는 curl을 사용하여 MCP 서버 내에서 현재 사용할 수 있는 모든 도구와 사양을 나열하는 방법을 보여줍니다.

curl 요청 
curl --location 'https://sheetsmcp.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'