googledocs-automation

Google Docs Automation via Rube MCP

Erstellen, bearbeiten, suchen, exportieren und verwalten Sie Google Docs-Dokumente programmatisch mit Rube MCP (Composio).

Toolkit-Dokumentation: composio.dev/toolkits/googledocs

Voraussetzungen

• Rube MCP muss verbunden sein (RUBE_SEARCH_TOOLS verfügbar)
• Aktive Verbindung über RUBE_MANAGE_CONNECTIONS mit dem Toolkit googledocs
• Rufen Sie immer zuerst RUBE_SEARCH_TOOLS auf, um die aktuellen Tool-Schemata zu erhalten

Einrichtung

Rube MCP beziehen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es werden keine API-Schlüssel benötigt – fügen Sie einfach den Endpunkt hinzu und es funktioniert.

1. Überprüfen Sie, ob Rube MCP verfügbar ist, indem Sie bestätigen, dass RUBE_SEARCH_TOOLS antwortet
2. Rufen Sie RUBE_MANAGE_CONNECTIONS mit dem Toolkit googledocs auf
3. Wenn die Verbindung nicht AKTIV ist, folgen Sie dem zurückgegebenen Auth-Link, um die Einrichtung abzuschließen
4. Bestätigen Sie, dass der Verbindungsstatus AKTIV anzeigt, bevor Sie Workflows ausführen

Kern-Workflows

1. Ein neues Dokument erstellen

Verwenden Sie GOOGLEDOCS_CREATE_DOCUMENT, um ein neues Google Doc mit einem Titel und anfänglichem Textinhalt zu erstellen.

Tool: GOOGLEDOCS_CREATE_DOCUMENT
Parameter:
  - title (erforderlich): Dateiname/Titel des Dokuments
  - text (erforderlich): Anfänglicher Textinhalt, der in das Dokument eingefügt werden soll

2. Dokumente suchen

Verwenden Sie GOOGLEDOCS_SEARCH_DOCUMENTS, um Google Docs nach Name, Inhalt, Datum oder Freigabestatus zu finden.

Tool: GOOGLEDOCS_SEARCH_DOCUMENTS
Parameter:
  - query: Suchabfrage-Zeichenfolge
  - max_results: Anzahl der Ergebnisse begrenzen
  - modified_after / created_after: Nach Datum filtern
  - shared_with_me: Freigegebene Dokumente filtern
  - starred_only: Mit Stern markierte Dokumente filtern
  - include_shared_drives: Freigegebene Laufwerke durchsuchen
  - order_by: Ergebnisse sortieren
  - page_token: Paginierungs-Token

3. Dokumentinhalt mit Markdown aktualisieren

Verwenden Sie GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN, um den gesamten Inhalt eines Dokuments durch Markdown-formatierten Text zu ersetzen.

Tool: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
Parameter:
  - id (erforderlich): Dokumenten-ID
  - markdown (erforderlich): Markdown-Inhalt, der den gesamten Dokumenttext ersetzt

4. Text suchen und ersetzen

Verwenden Sie GOOGLEDOCS_REPLACE_ALL_TEXT, um alle Vorkommen einer Zeichenfolge in einem Dokument zu ersetzen.

Tool: GOOGLEDOCS_REPLACE_ALL_TEXT
Parameter:
  - document_id (erforderlich): Ziel-Dokumenten-ID
  - find_text (erforderlich): Zu suchender Text
  - replace_text (erforderlich): Ersatztext
  - match_case: Groß-/Kleinschreibung beachten (boolesch)
  - search_by_regex: Regex zum Suchen von find_text verwenden
  - tab_ids: Bestimmte Tabs zum Durchsuchen

5. Dokument als PDF exportieren

Verwenden Sie GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF, um ein Google Doc in das PDF-Format zu exportieren.

Tool: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
Parameter:
  - file_id (erforderlich): Datei-ID des Dokuments
  - filename: Name der Ausgabe-PDF-Datei

6. Ein Dokument kopieren

Verwenden Sie GOOGLEDOCS_COPY_DOCUMENT, um ein vorhandenes Google Doc zu duplizieren.

Tool: GOOGLEDOCS_COPY_DOCUMENT
Parameter:
  - document_id (erforderlich): Quell-Dokumenten-ID zum Kopieren
  - title: Titel für die neue Kopie
  - include_shared_drives: Freigegebene Laufwerke nach der Quelle durchsuchen

Häufige Muster

• Suchen dann bearbeiten: Verwenden Sie GOOGLEDOCS_SEARCH_DOCUMENTS, um ein Dokument anhand des Namens zu finden, und dann die zurückgegebene Dokumenten-ID mit GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN oder GOOGLEDOCS_REPLACE_ALL_TEXT, um es zu ändern.
• Aus Vorlage erstellen: Verwenden Sie GOOGLEDOCS_COPY_DOCUMENT, um eine Vorlage zu duplizieren, und dann GOOGLEDOCS_REPLACE_ALL_TEXT, um Platzhaltertexte zu ersetzen.
• Abrufen dann aktualisieren: Verwenden Sie GOOGLEDOCS_GET_DOCUMENT_BY_ID, um den aktuellen Inhalt zu lesen, und wenden Sie dann Änderungen mit GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT an.
• Batch-Text-Einfügung: Verwenden Sie GOOGLEDOCS_INSERT_TEXT_ACTION, um Text an bestimmten Positionen (per Index) oder am Ende eines Dokuments anzuhängen.
• Dokumente teilen: Kombinieren Sie dies mit GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE (googledrive-Toolkit), um Dokumente nach der Erstellung zu teilen.

Bekannte Fallstricke

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN ersetzt den gesamten Dokumentinhalt – es hängt nicht an. Verwenden Sie es nur für vollständige Neuschreibungen.
• GOOGLEDOCS_INSERT_TEXT_ACTION erfordert einen präzisen insertion_index (Zeichenposition). Setzen Sie append_to_end: true, um Text sicher am Ende hinzuzufügen.
• GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT erfordert das Erstellen eines editDocs-Anforderungstexts mit rohen Google Docs-API-Batch-Update-Anfragen – konsultieren Sie die API-Dokumentation für die korrekte Struktur.
• Dokumenten-IDs und Datei-IDs sind für Google Docs derselbe Wert, aber die Parameternamen unterscheiden sich zwischen den Tools (id, document_id, file_id).
• GOOGLEDOCS_SEARCH_DOCUMENTS verwendet die Google Drive-Suchsyntax für den query-Parameter (z. B. name contains 'report').

Kurzreferenz

Aktion	Tool	Wichtige Parameter
Dokument erstellen	GOOGLEDOCS_CREATE_DOCUMENT	title, text
Dokumente suchen	GOOGLEDOCS_SEARCH_DOCUMENTS	query, max_results, modified_after
Dokument nach ID abrufen	GOOGLEDOCS_GET_DOCUMENT_BY_ID	id
Mit Markdown aktualisieren	GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN	id, markdown
Programmatische Bearbeitungen	GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT	document_id, editDocs
Text einfügen	GOOGLEDOCS_INSERT_TEXT_ACTION	document_id, text_to_insert, insertion_index
Suchen und ersetzen	GOOGLEDOCS_REPLACE_ALL_TEXT	document_id, find_text, replace_text
Als PDF exportieren	GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF	file_id, filename
Dokument kopieren	GOOGLEDOCS_COPY_DOCUMENT	document_id, title

---

Bereitgestellt von Composio