Naar inhoud
lightbulb Welkom op de nieuwe kennisbank | We hebben de docs volledig vernieuwd met meer dan 160 features. Bekijk wat nieuw isarrow_forward

Claude koppelen aan Google Workspace via MCP

Geef Claude toegang tot je Gmail, Google Drive en Google Calendar via het Model Context Protocol (MCP), met de ingebouwde connectoren of een eigen MCP-server.

Wat is MCP?

Het Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten zoals Claude verbinding maken met externe diensten en tools. MCP werkt als een brug: Claude kan via een MCP-server acties uitvoeren in andere systemen zonder dat jij de API zelf hoeft te programmeren.

Met een Google Workspace-koppeling kan Claude onder meer:

  • Google Drive-bestanden lezen en samenvatten
  • Gmail-berichten doorzoeken, lezen en concepten opstellen
  • Google Calendar-afspraken bekijken en aanmaken
  • Data uit Google Sheets en Docs analyseren

Sinds 2026 zijn er drie praktische manieren om dit op te zetten. We zetten ze hieronder op een rij, van eenvoudig naar geavanceerd.

info

Welke route past bij jou?

Ingebouwde connectoren zijn het makkelijkst en voor de meeste mensen genoeg. Een eigen remote connector geef je meer controle over de OAuth-rechten. De lokale CLI is voor wie alles op de eigen machine wil draaien of toegang tot extra Workspace-diensten nodig heeft.

Route 1: ingebouwde Workspace-connectoren (aanbevolen)

Gmail, Google Drive en Google Calendar zijn als kant-en-klare connectoren beschikbaar in Claude en Claude Desktop, voor alle abonnementen. Je hoeft niets te installeren of te configureren in de command line.

Zo activeer je een connector

  1. Open Claude of Claude Desktop en ga naar Instellingen, Connectoren.
  2. Kies de connector die je wilt gebruiken: Gmail, Google Drive of Google Calendar.
  3. Klik op verbinden en log in met je Google-account.
  4. Geef in het Google-toestemmingsscherm akkoord voor de gevraagde rechten.
  5. In een chat klik je op het plusteken, ga je naar Connectoren en schakel je per gesprek aan welke je wilt gebruiken.
warning

Werk je in een Team- of Enterprise-omgeving?

Bij Team- en Enterprise-abonnementen moet een eigenaar of beheerder de connectoren eerst organisatiebreed inschakelen onder de organisatie-instellingen. Pas daarna kunnen individuele gebruikers hun Google-account koppelen.

Route 2: eigen remote MCP-connector toevoegen

Wil je zelf bepalen welke rechten Claude krijgt, dan voeg je een eigen connector toe op basis van Google's officiele remote MCP-endpoints. Je hebt hiervoor een Google Cloud-project met OAuth-gegevens nodig.

OAuth-client aanmaken

OAuth-client in Google Cloud

  1. Ga naar console.cloud.google.com en maak een project aan, bijvoorbeeld Claude MCP.
  2. Open Google Auth Platform, Clients en kies Create Client.
  3. Selecteer Web application als type.
  4. Voeg als geautoriseerde redirect-URI https://claude.ai/api/mcp/auth_callback toe.
  5. Kopieer de Client ID en Client Secret die je terugkrijgt.

Connector koppelen in Claude

Custom connector toevoegen

  1. Ga in Claude of Claude Desktop naar Instellingen, Connectoren en klik op Add custom connector.
  2. Geef de connector een naam, bijvoorbeeld Gmail.
  3. Vul de remote MCP-server-URL in van de dienst die je wilt koppelen:
  4. - Gmail: https://gmailmcp.googleapis.com/mcp/v1
  5. - Drive: https://drivemcp.googleapis.com/mcp/v1
  6. - Calendar: https://calendarmcp.googleapis.com/mcp/v1
  7. - Chat: https://chatmcp.googleapis.com/mcp/v1
  8. Open Advanced settings en plak daar je Client ID en Client Secret.
  9. Klik op Add en herhaal de stappen voor elke dienst die je wilt toevoegen.

Route 3: lokale MCP-server met de officiele Workspace CLI

Google biedt een officiele command line-tool, gws, die de hele Workspace-API ontsluit en een ingebouwde MCP-server heeft. Die server draait lokaal over stdio, dus zonder open poorten of een vaste achtergrondservice. Dit is handig als je Claude toegang wilt geven tot diensten buiten de standaardconnectoren, zoals Docs, Slides of Tasks.

Vereisten

  • Claude Desktop (te downloaden via claude.ai/download)
  • Node.js 18 of hoger
  • Een Google Cloud-project met OAuth-gegevens
  • Basiskennis van de command line

CLI installeren

npm install -g @googleworkspace/cli

Controleer de installatie en log in met je Google-account:

gws auth login

De MCP-server start je met:

gws mcp

Claude Desktop laten verwijzen naar de lokale server

Bewerk het configuratiebestand van Claude Desktop:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-workspace": {
      "command": "gws",
      "args": ["mcp"],
      "env": {}
    }
  }
}

Sla het bestand op en herstart Claude Desktop. De Workspace-tools zijn dan beschikbaar in je gesprekken.

lightbulb

Scan op prompt-injectie

De officiele CLI heeft een --sanitize-optie die Workspace-antwoorden via Google Cloud Model Armor laat controleren op prompt-injectie voordat ze bij Claude terechtkomen. Handig wanneer Claude mail of documenten van derden leest.

Claude gebruiken met je Workspace

Zodra een route actief is, kun je in gewone taal opdrachten geven. Een paar praktische voorbeelden:

  • Lees het bestand 'Projectplan Q2' uit mijn Drive en maak een samenvatting in vijf punten.
  • Welke onbeantwoorde e-mails heb ik vandaag van klanten gekregen?
  • Wat staat er volgende week in mijn agenda, en zijn er dubbele afspraken?
  • Analyseer de verkoopcijfers in het Sheets-bestand 'Sales Q1' en geef de top vijf producten.

Rechten beperken

Geef Claude niet meer toegang dan nodig. Bij de ingebouwde connectoren bepaal je per gesprek welke je aanzet. Bij een eigen koppeling stel je de OAuth-scopes in op alleen-lezen waar dat kan:

{
  "scopes": [
    "https://www.googleapis.com/auth/drive.readonly",
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/gmail.readonly"
  ]
}

Met alleen-lezen-scopes kan Claude informatie opvragen maar niets wijzigen of verwijderen.

warning

Bedenk wat er in je context belandt

Elke MCP-tool levert precies de data terug die jij mag zien. Dat kan privacygevoelige informatie, contracten, financiele gegevens of inloggegevens bevatten, en die belanden ongefilterd in de context van het model. Koppel daarom geen accounts met toegang tot zeer gevoelige bedrijfssystemen, gebruik bij voorkeur alleen-lezen-rechten, en trek de toegang in via je Google-accountbeveiliging zodra je de koppeling niet meer nodig hebt.

Heb ik nog een aparte MCP-server nodig?

Voor Gmail, Drive en Calendar niet. Die zitten als ingebouwde connectoren in Claude en Claude Desktop. Een eigen server is alleen nodig als je extra controle wilt over de rechten of toegang tot andere Workspace-diensten zoals Docs, Slides of Tasks.

Kan Claude ook bestanden aanmaken en wijzigen?

Ja, als je schrijfrechten activeert. Wees voorzichtig, want Claude kan dan ook per ongeluk iets overschrijven of verwijderen. Begin daarom met alleen-lezen-rechten en breid pas uit als je vertrouwen hebt in de werkwijze.

Op welk abonnement werkt dit?

De ingebouwde Gmail-, Drive- en Calendar-connectoren zijn beschikbaar voor alle gebruikers van Claude en Claude Desktop. Bij Team- en Enterprise-omgevingen moet een beheerder de connectoren eerst organisatiebreed inschakelen.

Is MCP veilig voor zakelijk gebruik?

MCP zelf is volwassen geworden sinds de introductie, maar de data die je ontsluit blijft gevoelig. Beperk de rechten, gebruik waar mogelijk de --sanitize-optie tegen prompt-injectie, en stem het gebruik af met je beheerder voordat je bedrijfsdata koppelt.

Kunnen er meerdere MCP-servers tegelijk actief zijn?

Ja. Je kunt meerdere servers in claude_desktop_config.json zetten of meerdere connectoren aanzetten. Claude kan dan tools uit alle gekoppelde bronnen gebruiken.

Hoe verwijder ik de koppeling weer?

Schakel de connector uit in Claude, of verwijder de server uit claude_desktop_config.json. Trek daarna de app-toegang in via de beveiligingspagina van je Google-account, zodat de toestemming echt vervalt.