Google Docs MCP-Server

Dies ist ein Model Context Protocol (MCP)-Server, der Ihnen die Verbindung zu Google Docs über Claude ermöglicht. Mit diesem Server können Sie:

Listen Sie alle Google Docs in Ihrem Drive auf
Lesen Sie den Inhalt bestimmter Dokumente
Neue Dokumente erstellen
Vorhandene Dokumente aktualisieren
Suche nach Dokumenten
Dokumente löschen

Voraussetzungen

Node.js v16.0.0 oder höher
Google Cloud-Projekt mit aktivierter Google Docs API und Google Drive API
OAuth 2.0-Anmeldeinformationen für Ihr Google Cloud-Projekt

Aufstellen

Klonen Sie dieses Repository und navigieren Sie zum Projektverzeichnis:

git clone https://github.com/yourusername/MCP-Google-Doc.git
cd MCP-Google-Doc

Installieren Sie Abhängigkeiten:

npm install

Erstellen Sie eine OAuth 2.0-Client-ID in der Google Cloud Console:
- Gehen Sie zur Google Cloud Console
- Erstellen Sie ein neues Projekt oder wählen Sie ein vorhandenes aus
- Aktivieren Sie die Google Docs API und die Google Drive API
- Gehen Sie zu „APIs & Dienste“ > „Anmeldeinformationen“
- Klicken Sie auf „Anmeldeinformationen erstellen“ > „OAuth-Client-ID“.
- Wählen Sie als Anwendungstyp „Desktop-App“ aus
- Laden Sie die JSON-Datei herunter und speichern Sie sie als credentials.json in Ihrem Projektverzeichnis
Wichtig : Die Dateien credentials.json und token.json enthalten vertrauliche Informationen und sind von der Versionskontrolle über .gitignore ausgeschlossen. Übertragen Sie diese Dateien niemals in Ihr Repository.
Erstellen Sie das Projekt:

npm run build

Führen Sie den Server aus:

npm start

Wenn Sie den Server zum ersten Mal starten, werden Sie aufgefordert, sich bei Google zu authentifizieren. Folgen Sie den Anweisungen auf dem Bildschirm, um die Anwendung zu autorisieren. Dadurch wird eine token.json Datei generiert, in der Ihre Zugriffstoken gespeichert sind.

Sicherheitsüberlegungen

Sicherheit der Anmeldeinformationen : Sowohl credentials.json als auch token.json enthalten vertrauliche Informationen und sollten niemals weitergegeben oder der Versionskontrolle übergeben werden. Sie sind bereits der .gitignore Datei hinzugefügt.
Token-Aktualisierung : Die Anwendung aktualisiert das Zugriffstoken automatisch, wenn es abläuft.
Zugriff widerrufen : Wenn Sie den Zugriff widerrufen müssen, löschen Sie die Datei token.json und gehen Sie zu den Sicherheitseinstellungen Ihres Google-Kontos, um die App aus Ihren autorisierten Anwendungen zu entfernen.

Verbindung zu Claude für Desktop herstellen

So verwenden Sie diesen Server mit Claude für Desktop:

Bearbeiten Sie Ihre Claude Desktop-Konfigurationsdatei:
- Unter macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Unter Windows: %APPDATA%\Claude\claude_desktop_config.json
Fügen Sie Ihrer Konfiguration Folgendes hinzu:

{
  "mcpServers": {
    "googledocs": {
      "command": "node",
      "args": ["/absolute/path/to/build/server.js"]
    }
  }
}

Ersetzen Sie /absolute/path/to/build/server.js durch den tatsächlichen Pfad zu Ihrer erstellten server.js-Datei.

Starten Sie Claude für Desktop neu.

Benutzeroberfläche

Der Google Docs MCP-Server verfügt über eine benutzerfreundliche Dialogschnittstelle, die:

Präsentiert Dokumentinformationen in einem übersichtlichen, lesbaren Format
Verwendet natürliche Sprachantworten anstelle von API-Rohdaten
Formatiert Datumsangaben in einer für Menschen lesbaren Weise
Stellt hilfreiche Folgefragen nach Aktionen bereit
Gibt niemals vertrauliche Daten wie OAuth-Token preis

Dieses Schnittstellendesign ist so konzipiert, dass es zu anderen Claude MCP-Integrationen wie Notion passt und ein konsistentes und angenehmes Benutzererlebnis bietet.

Entwicklung

Projektstruktur

google-docs-integration/
├── build/                # Compiled JavaScript files
├── src/                  # TypeScript source code
│   └── server.ts         # Main server implementation
├── .gitignore            # Git ignore file
├── credentials.json      # OAuth 2.0 credentials (not in version control)
├── package.json          # Project dependencies and scripts
├── README.md             # Project documentation
├── token.json            # OAuth tokens (not in version control)
└── tsconfig.json         # TypeScript configuration

Neue Funktionen hinzufügen

So fügen Sie dem MCP-Server neue Funktionen hinzu:

Ändern Sie die Datei src/server.ts um neue Funktionen zu implementieren
Erstellen Sie das Projekt mit npm run build
Testen Sie Ihre Änderungen, indem Sie npm start ausführen

Verfügbare Ressourcen

googledocs://list - Listet alle Google Docs in Ihrem Drive auf
googledocs://{docId} – Ruft den Inhalt eines bestimmten Dokuments anhand der ID ab

Verfügbare Tools

create-doc - Erstellt ein neues Google-Dokument mit dem angegebenen Titel und optionalem Inhalt
update-doc – Aktualisiert ein vorhandenes Google-Dokument mit neuen Inhalten (anhängen oder ersetzen)
insert-text - Fügt Text direkt in ein Dokument ein, ohne Notion oder andere Integrationen
search-docs - Sucht nach Google Docs, die bestimmten Text enthalten
delete-doc – Löscht ein Google-Dokument anhand der ID

Verfügbare Eingabeaufforderungen

create-doc-template – Hilft beim Erstellen eines neuen Dokuments basierend auf einem bestimmten Thema und Schreibstil
analyze-doc - Analysiert den Inhalt eines Dokuments und liefert eine Zusammenfassung

Anwendungsbeispiele

Hier sind einige Beispielaufforderungen, die Sie mit Claude verwenden können, sobald die Verbindung zum Server hergestellt ist:

„Zeigen Sie mir eine Liste aller meiner Google Docs“
„Erstellen Sie ein neues Google-Dokument mit dem Titel ‚Besprechungsnotizen‘ und dem Inhalt ‚Zu besprechende Themen: …‘“
„Aktualisieren Sie mein Dokument mit der ID ‚1abc123def456‘, um diesen Abschnitt am Ende hinzuzufügen: …“
„Durchsuchen Sie meine Google Docs nach Dokumenten, die ‚Projektvorschlag‘ enthalten.“
„Löschen Sie das Google-Dokument mit der ID ‚1abc123def456‘“
„Erstellen Sie ein formelles Dokument zum Klimawandel“
„Analysieren Sie den Inhalt des Dokuments mit der ID ‚1abc123def456‘“

Fehlerbehebung

Wenn bei der Authentifizierung Probleme auftreten:

Löschen Sie die Datei token.json in Ihrem Projektverzeichnis
Führen Sie den Server erneut aus, um einen neuen Authentifizierungsablauf auszulösen

Wenn Sie Probleme mit der Google Docs-API haben:

Stellen Sie sicher, dass die API in Ihrer Google Cloud Console aktiviert ist
Überprüfen Sie, ob Ihre OAuth-Anmeldeinformationen die richtigen Bereiche haben

Beitragen

Forken Sie das Repository
Erstellen Sie einen Feature-Zweig: git checkout -b feature/your-feature-name
Übernehmen Sie Ihre Änderungen: git commit -am 'Add some feature'
Pushen zum Zweig: git push origin feature/your-feature-name
Senden einer Pull-Anfrage

Lizenz

MIT

Umgebungsvariablen

Erstellen Sie im Stammverzeichnis des Projekts eine .env Datei (oder exportieren Sie die Variablen in Ihrer Shell) mit den folgenden Schlüsseln:

# OAuth 2.0 client credentials – **JSON string** of the credentials file
GOOGLE_DOCS_CREDENTIALS_JSON={...}

# OAuth token – **JSON string** returned by the OAuth consent flow
GOOGLE_DOCS_TOKEN_JSON={...}

Wenn diese Variablen festgelegt sind, versucht der Server nicht , credentials.json oder token.json von der Festplatte zu lesen.

Google Docs MCP Server

Integrations