ComposioHQ/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-Schemas zu erhalten

Einrichtung

Rube MCP abrufen: Fügen Sie https://rube.app/mcp als MCP-Server in Ihrer Client-Konfiguration hinzu. Es sind keine API-Schlüssel erforderlich – einfach den Endpunkt hinzufügen 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 Authentifizierungslink, um die Einrichtung abzuschließen
4. Bestätigen Sie den Verbindungsstatus als AKTIV, bevor Sie Workflows ausführen

Kern-Workflows

1. Neues Dokument erstellen

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

Tool: GOOGLEDOCS_CREATE_DOCUMENT
Parameter:
  - title (erforderlich): Dateiname/Titel des Dokuments
  - text (erforderlich): Erster 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 durchsuchen.

Tool: GOOGLEDOCS_SEARCH_DOCUMENTS
Parameter:
  - query: Suchanfrage
  - max_results: Anzahl der Ergebnisse begrenzen
  - modified_after / created_after: Nach Datum filtern
  - shared_with_me: Freigegebene Dokumente filtern
  - starred_only: Markierte Dokumente filtern
  - include_shared_drives: Freigegebene Laufwerke durchsuchen
  - order_by: Ergebnisse sortieren
  - page_token: Paginierungstoken

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 Zeichenkette 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 für find_text verwenden
  - tab_ids: Bestimmte Tabs 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

6. 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 und dann bearbeiten: Verwenden Sie GOOGLEDOCS_SEARCH_DOCUMENTS, um ein Dokument anhand des Namens zu finden, und verwenden Sie 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 füllen.
• Abrufen und 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 (nach Index) einzufügen oder an das Ende eines Dokuments anzuhängen.
• Dokumente freigeben: Kombinieren Sie dies mit GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE (googledrive-Toolkit), um Dokumente nach der Erstellung freizugeben.

Bekannte Fallstricke

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN ersetzt den gesamten Dokumentinhalt – es hängt nichts an. Verwenden Sie es nur für vollständige Neuschreibungen.
• GOOGLEDOCS_INSERT_TEXT_ACTION erfordert einen genauen insertion_index (Zeichenposition). Setzen Sie append_to_end: true, um Text sicher am Ende hinzuzufügen.
• GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT erfordert die Erstellung eines editDocs-Anforderungstextes 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 identisch, aber die Parameternamen unterscheiden sich zwischen den Tools (id, document_id, file_id).
• GOOGLEDOCS_SEARCH_DOCUMENTS verwendet die Google Drive-Suchsyntax für den Parameter query (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 per ID abrufen	GOOGLEDOCS_GET_DOCUMENT_BY_ID	id
Mit Markdown aktualisieren	GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN	id, markdown
Programmgesteuerte Änderungen	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

---

Powered by Composio