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 が利用可能であることを確認します。- ツールキット
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