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 の入手: クライアント設定に MCP サーバーとして https://rube.app/mcp を追加します。API キーは不要です。エンドポイントを追加するだけで動作します。
RUBE_SEARCH_TOOLSが応答することを確認して、Rube MCP が利用可能であることを確認する- ツールキット
googledocsを指定してRUBE_MANAGE_CONNECTIONSを呼び出す - 接続が ACTIVE でない場合は、返された認証リンクに従ってセットアップを完了する
- ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認する
コアワークフロー
1. 新しいドキュメントを作成する
GOOGLEDOCS_CREATE_DOCUMENT を使用して、タイトルと初期テキストコンテンツを指定して新しい Google Doc を作成します。
ツール: GOOGLEDOCS_CREATE_DOCUMENT
パラメータ:
- title (必須): ドキュメントのファイル名/タイトル
- text (必須): ドキュメントに挿入する初期テキストコンテンツ
2. ドキュメントを検索する
GOOGLEDOCS_SEARCH_DOCUMENTS を使用して、名前、コンテンツ、日付、共有ステータスで Google Docs を検索します。
ツール: GOOGLEDOCS_SEARCH_DOCUMENTS
パラメータ:
- query: 検索クエリ文字列
- max_results: 結果の最大数
- modified_after / created_after: 日付でフィルタリング
- shared_with_me: 共有ドキュメントをフィルタリング
- starred_only: スター付きドキュメントをフィルタリング
- include_shared_drives: 共有ドライブを検索
- order_by: 結果の並び替え
- page_token: ページネーショントークン
3. Markdown でドキュメントコンテンツを更新する
GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN を使用して、ドキュメントの全コンテンツを Markdown 形式のテキストに置き換えます。
ツール: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
パラメータ:
- id (必須): ドキュメント ID
- markdown (必須): ドキュメント本文全体を置き換える Markdown コンテンツ
4. テキストを検索して置換する
GOOGLEDOCS_REPLACE_ALL_TEXT を使用して、ドキュメント内のすべての文字列の出現を置き換えます。
ツール: GOOGLEDOCS_REPLACE_ALL_TEXT
パラメータ:
- document_id (必須): ターゲットドキュメント ID
- find_text (必須): 検索するテキスト
- replace_text (必須): 置換テキスト
- match_case: 大文字と小文字を区別する(ブール値)
- search_by_regex: find_text に正規表現を使用する
- tab_ids: 検索する特定のタブ
5. ドキュメントを PDF としてエクスポートする
GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF を使用して、Google Doc を PDF 形式にエクスポートします。
ツール: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
パラメータ:
- file_id (必須): ドキュメントのファイル ID
- filename: 出力 PDF ファイル名
6. ドキュメントをコピーする
GOOGLEDOCS_COPY_DOCUMENT を使用して、既存の Google Doc を複製します。
ツール: GOOGLEDOCS_COPY_DOCUMENT
パラメータ:
- 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 |
| Markdown で更新 | 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 |
Powered by Composio