# Claude koppelen aan Google Workspace via MCP

[[TOC]]

## 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 title="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.

:::howto title="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.
:::

:::warn title="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

:::howto title="OAuth-client in Google Cloud"
1. Ga naar [console.cloud.google.com](https://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

:::howto title="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:
   - Gmail: `https://gmailmcp.googleapis.com/mcp/v1`
   - Drive: `https://drivemcp.googleapis.com/mcp/v1`
   - Calendar: `https://calendarmcp.googleapis.com/mcp/v1`
   - Chat: `https://chatmcp.googleapis.com/mcp/v1`
4. Open **Advanced settings** en plak daar je Client ID en Client Secret.
5. 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](https://claude.ai/download))
- Node.js 18 of hoger
- Een Google Cloud-project met OAuth-gegevens
- Basiskennis van de command line

### CLI installeren

```bash
npm install -g @googleworkspace/cli
```

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

```bash
gws auth login
```

De MCP-server start je met:

```bash
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`

```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.

:::tip title="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:

```json
{
  "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.

:::warn title="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.
:::

:::faq
### 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.
:::