Google Workspace MCP

by Taylor WilsdonConnectorGet organised

Lets your AI agent work in Gmail, Calendar, Drive, Docs, Sheets and other Google apps

About Google Workspace MCP

An open-source connector that links an AI assistant to 12 Google services, such as Gmail, Calendar, Drive and Docs. You run it on your computer with your own Google Cloud credentials; a read-only mode limits it.

For Google Workspace usersTeams on Gmail and DriveClaude and ChatGPT users

Made by Taylor Wilsdon

An open-source project by developer Taylor Wilsdon, published on GitHub.

Stars: ★ 3.4k
License: MIT
Cost: Free
Level: Advanced
Runs: Local · Self-hosted

Overview

Google Workspace MCP is an open-source connector that links an AI assistant to 12 Google services, including Gmail, Calendar, Drive, Docs, Sheets, Slides, Forms, Tasks, Contacts and Chat. You run it on your computer with your own Google Cloud OAuth client, add it to Claude, Claude Code or another MCP client, and then ask in plain words to search mail, schedule events or edit documents. A read-only mode and tool tiers limit what the agent can touch. It suits people who live in Google Workspace and are comfortable with a short technical setup.

It reaches twelve Google apps from one connector, and a read-only mode lets you start with look-but-don't-touch access.

Try these first

Start with the first one: it is a small task you can check easily.

List my five most recent unread emails and my events for tomorrow. Don't change anything.First try · read-only
Find a free hour next week for me and [colleague's email] and suggest three slots.
Draft a reply to the latest email from [sender] and save it as a draft, without sending.writes to Gmail
Add a row to [sheet name] with today's date and the total from [document name].edits a Sheet

Example prompts written by Agent Flows Hub.

Capabilities

From the creator's documentation.

Toolset	What your agent can do	Access
Gmail	Search, read, draft and send mail, and manage labels, filters and attachments	Read + write
Calendar	Read and create events and check free and busy times	Read + write
Drive	Search, create and share files, and import Office files	Read + write
Docs, Sheets, Slides	Edit text, tables, ranges, formatting and comments	Read + write
Forms, Tasks, Contacts	Build forms and read responses, manage task lists and contacts	Read + write
Read-only mode	Start with only read tools, or limit it to the services you list	Read

Good to know

You want an AI assistant to find emails, check your calendar or update a Google Doc for you. Workspace MCP gives an MCP client tools for 12 Google services, signed in through your own Google OAuth client.

Limits

Setup needs a Google Cloud project, an OAuth client and the right Google APIs turned on before any client can connect.
Emails and documents can contain hidden instructions aimed at the AI. Start in read-only mode and turn on sending or editing tools only when you need them.

Notes by Agent Flows Hub (original project name: google_workspace_mcp (workspace-mcp)), written from the creator's documentation, not from running it ourselves. Workspace MCP quick start · google_workspace_mcp README

Stuck setting it up?

Tell us what happened. We take a look first; if it needs paid work, you get an estimate before anything starts.

Get help

How to start

Open your AI agentClaude Code, Codex, Cursor or another agent that supports MCP.
Paste the install requestIt asks your agent to read the official instructions, tell you what it will connect to and wait for your OK.
Give it a first taskStart it in read-only mode with only Gmail and Calendar, then ask for your five most recent unread emails and tomorrow's events. Compare the answer with Gmail and Calendar.

Steps follow the creator's instructions. The request tells your agent to read them first and wait for your OK.

Before you start

An AI agent that supports MCP, such as Claude Code, Codex or Cursor.
Python 3.10 or newer and the uv tool
A Google Cloud project with an OAuth client and the Google APIs you plan to use turned on
An MCP client such as Claude Desktop, Claude Code or VS Code
It connects to the internet. Your agent will show you what before installing.
Free. Nothing to pay.

Details

Made by: Taylor Wilsdon
License: MIT Terms
Works with: Claude Code, CodexAs stated by the creator
Runs on: Your computer, Self-hosted server

View source Official docs Report a problem

For AI agents

This page as a Markdown install brief:

/en/library/google-workspace-mcp/install.md

Other connectors

Granola MCP Lets your AI assistant search and answer questions from your Granola meeting notes
ha-mcp for Home Assistant Lets your AI assistant control, build and fix automations in your Home Assistant
Korean Law MCP Lets your AI agent look up Korean laws and court decisions and check legal citations
Linear MCP Lets your AI agent find, create and update issues, projects and comments in Linear
Make MCP Server Lets your AI assistant run the automations you built in Make
Market Analysis MCP Lets your AI assistant pull market prices, run technical analysis and backtest strategies

See all 52 connectors · An MCP server is missing or disconnected

GitHub