| 1 | <!-- mcp-name: io.github.taylorwilsdon/workspace-mcp --> |
| 2 | |
| 3 | <div align="center"> |
| 4 | |
| 5 | # <span style="color:#cad8d9">Google Workspace MCP Server</span> <img src="https://github.com/user-attachments/assets/b89524e4-6e6e-49e6-ba77-00d6df0c6e5c" width="80" align="right" /> |
| 6 | |
| 7 | [](https://opensource.org/licenses/MIT) |
| 8 | [](https://www.python.org/downloads/) |
| 9 | [](https://pypi.org/project/workspace-mcp/) |
| 10 | [](https://pepy.tech/projects/workspace-mcp) |
| 11 | [](https://workspacemcp.com) |
| 12 | |
| 13 | *Full natural language control over Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts, and Chat through all MCP clients, AI assistants and developer tools.* |
| 14 | |
| 15 | *Includes a full featured CLI & Code Mode for use with tools like Claude Code and Codex!* |
| 16 | |
| 17 | **The most feature-complete Google Workspace MCP server**, it can do things that Google's own tooling and the built in integrations with Claude and ChatGPT can't even dream of. With Remote OAuth2.1 multi-user support, fine-grained editing tools and the most extensive coverage of any Google Workspace tool in existance, Workspace MCP is in a different class. Offering native OAuth 2.1, stateless mode and external auth server support, it's also the only Workspace MCP you can host for your whole organization centrally & securely! |
| 18 | |
| 19 | ###### Support for all free Google accounts & Google Workspace plans (Starter, Standard, Plus, Enterprise, Non Profit) with expanded app options like Chat & Spaces. <br/><br /> Interested in a private, managed cloud instance? [That can be arranged.](https://workspacemcp.com/workspace-mcp-cloud) |
| 20 | |
| 21 | |
| 22 | </div> |
| 23 | |
| 24 | <p align="center"> |
| 25 | <a href="https://workspacemcp.com/docs"> |
| 26 | <img src="https://img.shields.io/badge/Read%20the%20Docs-0969DA?style=for-the-badge&logo=readthedocs&logoColor=white" alt="Read the Docs"> |
| 27 | </a><br /><a href="https://workspacemcp.com/quick-start"> |
| 28 | <img src="https://img.shields.io/badge/Quick%20Start-2EA44F?style=for-the-badge" alt="Quick Start Guide"> |
| 29 | </a> |
| 30 | </p> |
| 31 | |
| 32 | <div align="center"> |
| 33 | <a href="https://www.pulsemcp.com/servers/taylorwilsdon-google-workspace"> |
| 34 | <img width="375" src="https://github.com/user-attachments/assets/0794ef1a-dc1c-447d-9661-9c704d7acc9d" align="center"/> |
| 35 | </a> |
| 36 | </div> |
| 37 | |
| 38 | --- |
| 39 | |
| 40 | <div align="center"> |
| 41 | <table> |
| 42 | <tr> |
| 43 | <td align="center"> |
| 44 | <b>⚡ Start</b><br> |
| 45 | <sub> |
| 46 | <a href="#quick-start">Quick Start</a> · <a href="#prerequisites">Prerequisites</a><br> |
| 47 | <a href="#configuration">Google Cloud</a> · <a href="#-credential-configuration">Credentials</a> |
| 48 | </sub> |
| 49 | </td> |
| 50 | <td align="center"> |
| 51 | <b>🧰 Tools</b><br> |
| 52 | <sub> |
| 53 | <a href="#-available-tools">All Tools</a> · <a href="#tool-tiers">Tool Tiers</a><br> |
| 54 | <a href="#cli">CLI</a> · <a href="#start-the-server">Start Server</a> |
| 55 | </sub> |
| 56 | </td> |
| 57 | <td align="center"> |
| 58 | <b>🔌 Connect</b><br> |
| 59 | <sub> |
| 60 | <a href="#quick-start--connect-claude-to-google-workspace">Quick Start</a> · <a href="#connect-to-claude-desktop">Claude Desktop</a><br> |
| 61 | <a href="#claude-code-mcp-client-support">Claude Code</a> · <a href="#vs-code-mcp-client-support">VS Code</a> · <a href="#connect-to-lm-studio">LM Studio</a> |
| 62 | </sub> |
| 63 | </td> |
| 64 | <td align="center"> |
| 65 | <b>🚀 Deploy</b><br> |
| 66 | <sub> |
| 67 | <a href="#oauth-21-support-multi-user-bearer-token-authentication">OAuth 2.1</a> · <a href="#stateless-mode-container-friendly">Stateless</a><br> |
| 68 | <a href="#external-oauth-21-provider-mode">External OAuth</a> · <a href="#reverse-proxy-setup">Reverse Proxy</a> |
| 69 | </sub> |
| 70 | </td> |
| 71 | <td align="center"> |
| 72 | <b>📐 Develop</b><br> |
| 73 | <sub> |
| 74 | <a href="#-development">Architecture</a> · <a href="#local-development-setup">Dev Setup</a><br> |
| 75 | <a href="#-security">Security</a> · <a href="#-lice |