Rube MCP를 통한 Google Docs 자동화
Rube MCP (Composio)를 사용하여 Google Docs 문서를 프로그래밍 방식으로 생성, 편집, 검색, 내보내기 및 관리합니다.
툴킷 문서: composio.dev/toolkits/googledocs
전제 조건
- Rube MCP가 연결되어 있어야 함 (
RUBE_SEARCH_TOOLS사용 가능) RUBE_MANAGE_CONNECTIONS를 통해googledocs툴킷으로 활성 연결 필요- 항상
RUBE_SEARCH_TOOLS를 먼저 호출하여 현재 도구 스키마를 확인
설정
Rube MCP 받기: 클라이언트 구성에 https://rube.app/mcp를 MCP 서버로 추가합니다. API 키는 필요 없습니다 — 엔드포인트만 추가하면 작동합니다.
RUBE_SEARCH_TOOLS가 응답하는지 확인하여 Rube MCP 사용 가능 여부 확인RUBE_MANAGE_CONNECTIONS를googledocs툴킷으로 호출- 연결이 ACTIVE 상태가 아니면 반환된 인증 링크를 따라 설정 완료
- 워크플로우 실행 전에 연결 상태가 ACTIVE인지 확인
핵심 워크플로우
1. 새 문서 만들기
GOOGLEDOCS_CREATE_DOCUMENT를 사용하여 제목과 초기 텍스트 내용으로 새 Google Doc을 만듭니다.
Tool: GOOGLEDOCS_CREATE_DOCUMENT
Parameters:
- title (필수): 문서 파일명/제목
- text (필수): 문서에 삽입할 초기 텍스트 내용
2. 문서 검색
GOOGLEDOCS_SEARCH_DOCUMENTS를 사용하여 이름, 내용, 날짜 또는 공유 상태로 Google Docs를 찾습니다.
Tool: GOOGLEDOCS_SEARCH_DOCUMENTS
Parameters:
- query: 검색 쿼리 문자열
- max_results: 결과 개수 제한
- modified_after / created_after: 날짜로 필터링
- shared_with_me: 공유 문서 필터링
- starred_only: 별표 표시된 문서만 필터링
- include_shared_drives: 공유 드라이브 검색
- order_by: 결과 정렬
- page_token: 페이지네이션 토큰
3. 마크다운으로 문서 내용 업데이트
GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN을 사용하여 문서 전체 내용을 마크다운 형식의 텍스트로 교체합니다.
Tool: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
Parameters:
- id (필수): 문서 ID
- markdown (필수): 문서 본문을 대체할 마크다운 내용
4. 텍스트 찾기 및 바꾸기
GOOGLEDOCS_REPLACE_ALL_TEXT를 사용하여 문서에서 모든 문자열을 바꿉니다.
Tool: GOOGLEDOCS_REPLACE_ALL_TEXT
Parameters:
- document_id (필수): 대상 문서 ID
- find_text (필수): 검색할 텍스트
- replace_text (필수): 대체할 텍스트
- match_case: 대소문자 일치 (boolean)
- search_by_regex: find_text에 정규식 사용
- tab_ids: 특정 탭 검색
5. 문서를 PDF로 내보내기
GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF를 사용하여 Google Doc을 PDF 형식으로 내보냅니다.
Tool: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
Parameters:
- file_id (필수): 문서 파일 ID
- filename: 출력 PDF 파일명
6. 문서 복사
GOOGLEDOCS_COPY_DOCUMENT를 사용하여 기존 Google Doc을 복제합니다.
Tool: GOOGLEDOCS_COPY_DOCUMENT
Parameters:
- document_id (필수): 복사할 원본 문서 ID
- title: 새 복사본의 제목
- include_shared_drives: 원본 검색 시 공유 드라이브 포함
일반적인 패턴
- 검색 후 편집:
GOOGLEDOCS_SEARCH_DOCUMENTS로 이름으로 문서를 찾은 후, 반환된 문서 ID를GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN또는GOOGLEDOCS_REPLACE_ALL_TEXT와 함께 사용하여 수정합니다. - 템플릿에서 생성:
GOOGLEDOCS_COPY_DOCUMENT로 템플릿을 복제한 후,GOOGLEDOCS_REPLACE_ALL_TEXT로 플레이스홀더 텍스트를 채웁니다. - 검색 후 업데이트:
GOOGLEDOCS_GET_DOCUMENT_BY_ID로 현재 내용을 읽은 후,GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT로 편집을 적용합니다. - 배치 텍스트 삽입:
GOOGLEDOCS_INSERT_TEXT_ACTION을 사용하여 특정 위치(인덱스 기준)에 텍스트를 삽입하거나 문서 끝에 추가합니다. - 문서 공유: 생성 후
GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE(googledrive 툴킷)와 결합하여 문서를 공유합니다.
알려진 문제점
GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN은 문서 전체 내용을 교체합니다 — 추가하는 것이 아닙니다. 전체 다시 쓰기에만 사용하세요.GOOGLEDOCS_INSERT_TEXT_ACTION은 정확한insertion_index(문자 위치)가 필요합니다. 안전하게 텍스트를 끝에 추가하려면append_to_end: true를 설정하세요.GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT는 원시 Google Docs API 배치 업데이트 요청으로editDocs요청 본문을 구성해야 합니다 — 올바른 구조는 API 문서를 참조하세요.- Google Docs에서 문서 ID와 파일 ID는 동일한 값이지만, 도구마다 매개변수 이름이 다릅니다 (
id,document_id,file_id). GOOGLEDOCS_SEARCH_DOCUMENTS는query매개변수에 Google Drive 검색 구문을 사용합니다 (예:name contains 'report').
빠른 참조
| 작업 | 도구 | 주요 매개변수 |
|---|---|---|
| 문서 만들기 | GOOGLEDOCS_CREATE_DOCUMENT | title, text |
| 문서 검색 | GOOGLEDOCS_SEARCH_DOCUMENTS | query, max_results, modified_after |
| ID로 문서 가져오기 | GOOGLEDOCS_GET_DOCUMENT_BY_ID | id |
| 마크다운으로 업데이트 | GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN | id, markdown |
| 프로그래밍 방식 편집 | GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT | document_id, editDocs |
| 텍스트 삽입 | GOOGLEDOCS_INSERT_TEXT_ACTION | document_id, text_to_insert, insertion_index |
| 찾기 및 바꾸기 | GOOGLEDOCS_REPLACE_ALL_TEXT | document_id, find_text, replace_text |
| PDF로 내보내기 | GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF | file_id, filename |
| 문서 복사 | GOOGLEDOCS_COPY_DOCUMENT | document_id, title |
Composio 제공