ComposioHQ/Excel-Automation

Was macht Excel-Automation?

Automatisieren Sie Tabellenkalkulationsvorgänge, einschließlich der Erstellung von Arbeitsmappen, dem Schreiben von Daten, dem Formatieren von Zellen, dem Upserten von Zeilen und der Verwaltung von Arbeitsblättern. Funktioniert mit Microsoft Excel (OneDrive) und Google Sheets.

Toolkit-Dokumentation: composio.dev/toolkits/excel

---

Einrichtung

Dieses Skill erfordert den Rube MCP-Server, der unter https://rube.app/mcp angeschlossen ist.

Stellen Sie vor der Ausführung von Tools sicher, dass eine aktive Verbindung für das excel- (und optional googlesheets-) Toolkit besteht. Wenn keine aktive Verbindung vorhanden ist, initiieren Sie eine über RUBE_MANAGE_CONNECTIONS.

---

Kern-Workflows

1. Neue Excel-Arbeitsmappe erstellen

Verwenden Sie EXCEL_CREATE_WORKBOOK, um eine neue .xlsx-Datei zu generieren und in OneDrive hochzuladen.

Tool: EXCEL_CREATE_WORKBOOK

Schritte:

1. Rufen Sie EXCEL_CREATE_WORKBOOK mit Arbeitsblattnamen und Daten auf
2. Das Tool erstellt eine .xlsx-Datei und lädt sie in OneDrive hoch
3. Verwenden Sie den zurückgegebenen Dateipfad/URL für nachfolgende Operationen

---

2. Daten in eine Tabelle schreiben

Verwenden Sie GOOGLESHEETS_BATCH_UPDATE, um Werte in einen bestimmten Bereich zu schreiben oder Zeilen anzuhängen.

Tool: GOOGLESHEETS_BATCH_UPDATE

Wichtige Parameter:

• spreadsheet_id (erforderlich) – Die Tabellen-ID aus der URL (44-stellige alphanumerische Zeichenfolge)
• sheet_name (erforderlich) – Tabellenname, z.B. "Sheet1", "Sales Data"
• values (erforderlich) – 2D-Array von Zellenwerten, z.B. [["Name","Betrag"],["Alice",100]]
• first_cell_location – Startzelle in A1-Notation (z.B. "A1", "D3"). Weglassen, um Zeilen anzuhängen
• valueInputOption – "USER_ENTERED" (Standard, parst Formeln) oder "RAW" (speichert unverändert)

Beispiel:

Tool: GOOGLESHEETS_BATCH_UPDATE
Argumente:
  spreadsheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  sheet_name: "Sheet1"
  values: [["Artikel","Kosten","Gelagert"],["Rad",20.50,true],["Schraube",0.50,true]]
  first_cell_location: "A1"

---

3. Zeilen nach Schlüsselspalte upserten

Verwenden Sie GOOGLESHEETS_UPSERT_ROWS, um vorhandene Zeilen durch Abgleich einer Schlüsselspalte zu aktualisieren oder neue Zeilen anzuhängen, wenn keine Übereinstimmung gefunden wird. Ideal für CRM-Synchronisationen, Inventaraktualisierungen und Deduplizierung.

Tool: GOOGLESHEETS_UPSERT_ROWS

Wichtige Parameter:

• spreadsheetId (erforderlich) – Die Tabellen-ID
• sheetName (erforderlich) – Tabellenname
• rows (erforderlich) – 2D-Array von Datenzeilen (mindestens 1 Zeile). Wenn headers weggelassen wird, wird die erste Zeile als Kopfzeile behandelt
• headers – Spaltennamen für die Daten, z.B. ["Email","Telefon","Status"]
• keyColumn – Spaltenüberschrift für den Abgleich, z.B. "Email", "SKU", "Lead ID"
• strictMode – true (Standard) gibt Fehler bei nicht übereinstimmenden Spalten aus; false kürzt stillschweigend

Beispiel:

Tool: GOOGLESHEETS_UPSERT_ROWS
Argumente:
  spreadsheetId: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  sheetName: "Kontakte"
  keyColumn: "Email"
  headers: ["Email","Telefon","Status"]
  rows: [["[email protected]","555-0101","Aktiv"],["[email protected]","555-0102","Ausstehend"]]

---

4. Zellen formatieren

Verwenden Sie GOOGLESHEETS_FORMAT_CELL, um Fettdruck, Kursivschrift, Schriftgröße und Hintergrundfarben auf Bereiche anzuwenden.

Tool: GOOGLESHEETS_FORMAT_CELL

Wichtige Parameter:

• spreadsheet_id (erforderlich) – Die Tabellen-ID
• range – Zellenbereich in A1-Notation, z.B. "A1:D1", "B2:B10" (empfohlen gegenüber indexbasierter Angabe)
• sheet_name – Arbeitsblattname, z.B. "Sheet1"
• bold – true/false
• italic – true/false
• fontSize – Schriftgröße in Punkt, z.B. 12
• red, green, blue – Hintergrundfarbkomponenten (0.0–1.0 Gleitkommawerte, NICHT 0–255)

Beispiel (fette Kopfzeile mit blauem Hintergrund):

Tool: GOOGLESHEETS_FORMAT_CELL
Argumente:
  spreadsheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  range: "A1:D1"
  sheet_name: "Sheet1"
  bold: true
  fontSize: 12
  red: 0.2
  green: 0.4
  blue: 0.9

---

5. Neue Arbeitsblattregisterkarten hinzufügen

Verwenden Sie GOOGLESHEETS_ADD_SHEET, um neue Registerkarten in einer vorhandenen Tabelle zu erstellen.

Tool: GOOGLESHEETS_ADD_SHEET

Wichtige Parameter:

• spreadsheetId (erforderlich) – Die Tabellen-ID
• title – Name für die neue Registerkarte, z.B. "Q4 Bericht"
• forceUnique – true (Standard) hängt bei Namenskonflikt automatisch ein Suffix an

Beispiel:

Tool: GOOGLESHEETS_ADD_SHEET
Argumente:
  spreadsheetId: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  title: "Q4 Bericht"
  forceUnique: true

---

6. Daten lesen und Inhalt überprüfen

Verwenden Sie GOOGLESHEETS_BATCH_GET, um Daten aus bestimmten Zellbereichen zur Validierung oder Weiterverarbeitung abzurufen.

Tool: GOOGLESHEETS_BATCH_GET

Schritte:

1. Rufen Sie GOOGLESHEETS_BATCH_GET mit der Tabellen-ID und den Zielbereichen auf
2. Validieren Sie Kopfzeilen und Datenausrichtung
3. Verwenden Sie die Ergebnisse für nachfolgende Schreib- oder Aktualisierungsvorgänge

Unterstützende Tools:

• GOOGLESHEETS_GET_SHEET_NAMES – Alle Registerkartennamen in einer Tabelle auflisten
• GOOGLESHEETS_GET_SPREADSHEET_INFO – Metadaten abrufen (Blatt-IDs, Eigenschaften)
• GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE – Prüfen, ob eine bestimmte Registerkarte existiert

---

Empfohlener Ausführungsplan

1. Tabelle erstellen oder lokalisieren mit GOOGLESHEETS_CREATE_GOOGLE_SHEET1 oder einer vorhandenen spreadsheetId wiederverwenden
2. Zielregisterkarte bestätigen mit GOOGLESHEETS_GET_SHEET_NAMES oder GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE; bei Fehlen mit GOOGLESHEETS_ADD_SHEET erstellen
3. Vorhandene Kopfzeilen lesen (optional) mit GOOGLESHEETS_BATCH_GET, um Spalten auszurichten
4. Daten schreiben oder upserten mit GOOGLESHEETS_BATCH_UPDATE oder GOOGLESHEETS_UPSERT_ROWS
5. Formatierung anwenden (optional) mit GOOGLESHEETS_FORMAT_CELL
6. Ergebnisse überprüfen (optional) mit GOOGLESHEETS_BATCH_GET
7. Fallback: Wenn die Google-Tabellenerstellung blockiert ist (HTTP 403), EXCEL_CREATE_WORKBOOK für lokale .xlsx-Ausgabe verwenden

---

Bekannte Fallstricke

Fallstrick	Detail
HTTP 403 bei Tabellenerstellung	GOOGLESHEETS_CREATE_GOOGLE_SHEET1 schlägt fehl, wenn der Drive-Erstellungsbereich fehlt. Verwenden Sie eine vorhandene spreadsheetId erneut oder greifen Sie auf EXCEL_CREATE_WORKBOOK zurück.
Zellenlimit und Ratenbegrenzung	Google Sheets hat ein Limit von ca. 5.000.000 Zellen pro Tabelle. Übermäßige Schreibfrequenz führt zu HTTP 429. Fassen Sie Änderungen zusammen und teilen Sie große Schreibvorgänge auf (~500 Zeilen/Aufruf).
Formatbereich um eins verschoben	GOOGLESHEETS_FORMAT_CELL verwendet 0-basierte, endIndex-exklusive Bereiche im Indexmodus. Hintergrundfarbe verwendet 0–1 Gleitkomma-RGB, NICHT 0–255 Ganzzahl-RGB.
Eindeutigkeit von Blattnamen	Blattnamen sind in API-Antworten nicht garantiert eindeutig. Bevorzugen Sie die Arbeit mit numerischer sheetId und überprüfen Sie die aufgelöste Registerkarte vor dem Schreiben.
Upsert-Payload-Format	GOOGLESHEETS_UPSERT_ROWS erfordert Kopfzeilen + 2D-Zeilen-Array. Das Senden von Listen-von-Dicts oder leeren rows führt zu Validierungsfehlern. Stellen Sie mindestens 1 Datenzeile sicher.

---

Kurzreferenz

Tool Slug	Beschreibung
EXCEL_CREATE_WORKBOOK	Neue .xlsx-Arbeitsmappe erstellen und in OneDrive hochladen
GOOGLESHEETS_BATCH_UPDATE	Werte in einen Bereich schreiben oder neue Zeilen anhängen
GOOGLESHEETS_UPSERT_ROWS	Vorhandene Zeilen per Schlüssel aktualisieren oder neue anhängen
GOOGLESHEETS_FORMAT_CELL	Text-/Hintergrundformatierung auf Zellbereiche anwenden
GOOGLESHEETS_ADD_SHEET	Neue Arbeitsblattregisterkarte zu einer Tabelle hinzufügen
GOOGLESHEETS_CREATE_GOOGLE_SHEET1	Neue Google-Tabelle in Drive erstellen
GOOGLESHEETS_GET_SHEET_NAMES	Alle Arbeitsblattnamen in einer Tabelle auflisten
GOOGLESHEETS_GET_SPREADSHEET_INFO	Tabellenmetadaten abrufen
GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE	Prüfen, ob ein Arbeitsblatt mit einem bestimmten Titel existiert
GOOGLESHEETS_BATCH_GET	Daten aus bestimmten Zellbereichen lesen

---

Bereitgestellt von Composio