Microsoft Excel zu MCP: Microsoft Excel aus jedem KI-Agent steuern

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Excel (Microsoft 365) klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Microsoft Excel

Lass deine KI mit Excel-Arbeitsmappen in OneDrive und SharePoint arbeiten: Tabellenblätter auflisten, beliebige Bereiche oder den genutzten Bereich eines Blatts lesen, Werte und Formeln schreiben, Tabellenzeilen lesen und anhängen, Tabellenblätter hinzufügen und Tabellen anlegen. Microsoft 365 über die Workbook-API von Microsoft Graph, angemeldet mit deinem Microsoft-Konto.

Einrichtung

1. Öffne das Microsoft Entra Admin Center (entra.microsoft.com) oder das Azure-Portal und gehe zu Applications → App registrations → New registration.

2. Gib der App einen Namen (zum Beispiel „AnythingMCP Microsoft 365“) und wähle die Supported account types. Davon hängt ab, was in MICROSOFT_TENANT_ID gehört:

   • Accounts in this organizational directory only (Single-Tenant): Nur Benutzer deiner Organisation können sich anmelden. Trage die Directory (tenant) ID von der Overview-Seite der App ein (eine GUID) oder deine Domain, etwa contoso.onmicrosoft.com.
   • Accounts in any organizational directory (Multi-Tenant): trage organizations ein.
   • Accounts in any organizational directory and personal Microsoft accounts: trage common ein (Geschäfts-, Schul- und private Konten) oder consumers (nur private Konten).

   Passt der Wert nicht zum Kontotyp, lehnt Microsoft die Anmeldung ab (AADSTS50194 oder AADSTS50020).

3. Wähle unter Redirect URI die Plattform Web und trage https://cloud.anythingmcp.com/api/mcp-oauth/callback ein. Wenn du AnythingMCP selbst betreibst, trage stattdessen https://dein-anythingmcp-host/api/mcp-oauth/callback ein. Die URI muss Zeichen für Zeichen übereinstimmen, sonst antwortet Microsoft mit AADSTS50011.

4. Öffne API permissions → Add a permission → Microsoft Graph → Delegated permissions und füge offline_access, User.Read und Files.ReadWrite hinzu. offline_access sorgt dafür, dass Microsoft einen Refresh-Token ausstellt; ohne diese Berechtigung hört der Connector eine Stunde nach der Autorisierung auf zu arbeiten.

5. Öffne Certificates & secrets → New client secret. Kopiere den Value des Secrets, nicht die Secret ID; er wird nur einmal angezeigt. Notiere dir das Ablaufdatum: Wenn das Secret abläuft, funktioniert der Connector nicht mehr, bis du ein neues erstellst und einträgst.

6. Trage die Application (client) ID von der Overview-Seite in MICROSOFT_CLIENT_ID ein, den Secret-Wert in MICROSOFT_CLIENT_SECRET und den Tenant-Wert aus Schritt 2 in MICROSOFT_TENANT_ID, dann installiere den Connector.

7. Klicke auf der Connector-Seite auf Authorize with Provider und melde dich mit dem Konto an, mit dessen Arbeitsmappen die KI arbeiten soll. Der Refresh-Token wird verschlüsselt gespeichert, Access-Tokens (etwa eine Stunde gültig) werden automatisch erneuert.

8. Beginne mit excel_get_my_drive: Das Tool zeigt, an welchem OneDrive der Connector angemeldet ist.

Eine Entra-App für alle Microsoft-Connectors: Die App-Registrierung, die du für den Outlook-, OneDrive- oder SharePoint-Connector angelegt hast, funktioniert auch hier. Öffne sie, füge unter API permissions die Berechtigung aus Schritt 4 hinzu, behalte dieselbe Redirect URI und verwende dieselbe Client-ID, dasselbe Secret und denselben Tenant. Jeder Connector fragt bei der Autorisierung nur nach seinen eigenen Berechtigungen:

• Outlook: Mail.ReadWrite, Mail.Send, Calendars.ReadWrite
• OneDrive: Files.ReadWrite
• Excel: Files.ReadWrite (plus Files.ReadWrite.All für Arbeitsmappen in SharePoint oder solche, die mit dir geteilt wurden)
• SharePoint: Sites.ReadWrite.All und Files.ReadWrite.All

Alle brauchen außerdem offline_access und User.Read.

Administratorzustimmung: Diese delegierten Berechtigungen brauchen normalerweise keinen Administrator, aber viele Organisationen schalten die Benutzerzustimmung ab. Zeigt die Anmeldung „Need admin approval“ (AADSTS65001 oder AADSTS90094), öffnet ein Tenant-Administrator einmal die App-Registrierung und klickt auf API permissions → Grant admin consent für die Organisation. Danach kann jeder Benutzer autorisieren. Jeder Connector arbeitet trotzdem nur mit dem, was das angemeldete Konto sehen darf.

Arbeitsmappen in SharePoint oder mit dir geteilt: Files.ReadWrite deckt die Arbeitsmappen in deinem eigenen OneDrive ab. Für Arbeitsmappen in SharePoint-Bibliotheken oder solche, die andere mit dir geteilt haben, füge der App-Registrierung Files.ReadWrite.All hinzu, ersetze damit in den OAuth-Einstellungen des Connectors Files.ReadWrite und autorisiere erneut. Die KI findet eine Arbeitsmappe in deinem OneDrive über ihren Namen oder Pfad (zum Beispiel Finance/Budget 2026.xlsx); für eine SharePoint-Bibliothek nimmt sie die Drive-ID der Bibliothek aus dem Microsoft-SharePoint-Connector.

Arbeitsmappen unverändert lassen: Selbst das Lesen einer Arbeitsmappe braucht eine Schreibberechtigung, weil Microsoft Graph sie in einer Excel-Sitzung öffnet. Damit die KI keine Arbeitsmappen ändert, deaktiviere excel_update_range, excel_add_worksheet, excel_add_table_rows und excel_create_table.

Bei der Installation ausgeschaltet: excel_clear_range und excel_delete_worksheet. Beides lässt sich über die API nicht rückgängig machen, nur über den Versionsverlauf der Datei. Schalte sie nur ein, wenn die KI sie wirklich braucht.

Lesen und Schreiben: Nur .xlsx-Dateien (sowie .xlsm und .xlsb) funktionieren, .xls- und .csv-Dateien nicht. Datumswerte kommen als Excel-Seriennummern, sofern die KI nicht den angezeigten Text anfordert, und große Tabellenblätter werden in Zeilenblöcken gelesen. Zeilen an eine Excel-Tabelle anzuhängen ist der sicherste Weg, Datensätze hinzuzufügen: Die Tabelle wächst mit und behält ihre Formeln und Formate. Formeln verwenden englische Funktionsnamen und Kommas, zum Beispiel =SUM(B2:B20). Jede Änderung wird sofort in der Datei gespeichert, und Excel im Web und die Desktop-App sehen sie. Private OneDrive-Konten unterstützen die meisten Lese- und Bereichs-Tools, aber keine Tabellenzeilen.

Limits: Microsoft Graph verarbeitet Arbeitsmappen bis etwa 100 MB, und eine Anfrage bricht nach etwa 30 Sekunden ab, halte die Bereiche also überschaubar. Wenn jemand die Datei in der Excel-Desktop-App mit ungespeicherten Änderungen geöffnet hat oder eine große Arbeitsmappe noch lädt, kann Graph mit 409 oder 504 antworten: Warte einen Moment und versuche es erneut.

Häufige Fehler: 401 InvalidAuthenticationToken heißt, dass die Autorisierung widerrufen wurde oder das Client Secret abgelaufen ist; trage bei Bedarf ein neues Secret ein und klicke erneut auf Authorize with Provider. 403 accessDenied heißt, dass eine Berechtigung fehlt oder die Arbeitsmappe jemand anderem gehört und dem Scope Files.ReadWrite.All fehlt. 404 itemNotFound heißt, dass die Arbeitsmappe falsch ist oder es das Tabellenblatt oder die Tabelle mit diesem Namen nicht gibt. 400 InvalidArgument heißt, dass Excel eine Adresse nicht lesen kann oder die Werte nicht zur Form des Bereichs passen. UnsupportedWorkbook oder NotSupported heißt, dass die Datei keine .xlsx-Datei ist, passwortgeschützt ist oder zu groß für die Workbook-API.

Der Connector legt keine neuen Arbeitsmappendateien, Diagramme, PivotTables oder benannten Elemente an und formatiert Zellen nur über Zahlenformate.

Voraussetzungen: MICROSOFT_CLIENT_ID, MICROSOFT_CLIENT_SECRET, MICROSOFT_TENANT_ID

Connector lokal installieren

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Öffne http://localhost:3000/connectors/store, wähle Excel (Microsoft 365) und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Öffne Finanzen/Budget 2026.xlsx und sag mir, welche Kostenstellen über dem Budget liegen.“
• „Füge diese drei Ausgaben als neue Zeilen in die Tabelle Ausgaben in meiner Reisekosten-Arbeitsmappe ein.“
• „Lies das Tabellenblatt Umsatz und schreib die Monatssummen in ein neues Blatt namens Übersicht.“
• „Welche Tabellenblätter hat die Arbeitsmappe Preise 2026, und wie viele Zeilen nutzt jedes davon?“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden