Google Workspace MCP Server

1# Google Workspace MCP Server
2 
3A Model Context Protocol (MCP) server that acts as a secure bridge between your personal Google Workspace account (Gmail, Calendar, etc.) and any MCP-compatible AI client, such as Claude Desktop.
4 
5## Features
6 
7*   **Google Calendar**:
8    *   Effortlessly list and search for events on your primary calendar within a specific date range.
9    *   Create new events with detailed information like title, description, start, and end times.
10    *   Update existing events, allowing for partial modifications such as changing the title or time.
11    *   Delete events directly from your calendar.
12*   **Gmail**:
13    *   Read the content of your most recent email to stay up-to-date.
14    *   Search for specific emails by their subject line to find important conversations.
15    *   Compose and send new emails directly from your account.
16*   **Google Drive**:
17    *   Search for files and folders using powerful query strings.
18    *   Create new Google Docs with a specified title and initial content.
19    *   Update the entire content of an existing Google Doc.
20    *   Manage your files by moving them to the bin or deleting them permanently.
21 
22## Getting Started
23 
24Follow these steps to set up the server and run the example AI agent.
25 
26### Prerequisites
27 
28*   Python 3.9+ and `uv` (or `pip`).
29*   A Google Cloud project with the necessary APIs enabled.
30*   Claude Desktop.
31 
32### Step 1: Configure your Google Cloud Project
33 
34You need to authorize this application to access your Google data. This is a one-time setup.
35 
361.  **Go to the Google Cloud Console**: [https://console.cloud.google.com/](https://console.cloud.google.com/)
372.  **Create a new project** (or use an existing one).
383.  **Enable APIs**:
39    *   Go to "APIs & Services" -> "Library".
40    *   Search for and **Enable** the **Gmail API**.
41    *   Search for and **Enable** the **Google Calendar API**.
42    *   Search for and **Enable** the **Google Drive API**.
434.  **Create OAuth Credentials**:
44    *   Go to "APIs & Services" -> "Credentials".
45    *   Click "Create Credentials" -> "OAuth client ID".
46    *   If prompted, configure the "OAuth consent screen". Choose **External** and provide a name for the app. You can skip most other fields for personal use. Add your Google account email as a Test User.
47    *   For "Application type", select **Desktop app**.
48    *   Give it a name (e.g., "GSuite MCP Client").
495.  **Download Credentials**:
50    *   After creating the client ID, click the "Download JSON" icon.
51    *   Rename the downloaded file to `client_secrets.json` and place it in the **root directory of this project**.
52 
53### Step 2: Install Dependencies
54 
55Clone this repository and install the required Python packages for both the server and the client.
56 
57```bash
58git clone <your-repo-url>
59cd <your-repo-name>
60uv venv # Create a virtual environment
61source .venv/bin/activate # On Windows: .venv\Scripts\activate
62# Install server dependencies
63uv install -r requirements.txt
64```
65 
66### Step 3: Run the One-Time Authorization
67 
68Before you can run the server, you need to authorize it with your Google account. Run the `get_credentials.py` script from your terminal:
69 
70```bash
71python get_credentials.py
72```
73 
74*   This will open a browser window.
75*   Log in with your Google account and grant the requested permissions.
76*   After you approve, the script will automatically create a `token.json` file in the project directory. This file stores your authorization tokens so you don't have to log in every time.
77 
78### Step 4: Set Up and Run the AI Agent Client
79 
80As an example, I'll show you how to configure Claude Desktop as an MCP Client. However, you can use whatever MCP Client available on Internet.
81 
821.  **Configure Claude Desktop**:
83    
84    (Windows) Open `C:\Users\<user>\AppData\Roaming\Claude\claude_desktop_config.json` and add 
85    ```json
86    {
87        "mcpServers": {
88            "GsuiteMCPServer": {
89                "command": "absolute-path-to-your-python-executable-in-virtual-environment",
90                "args": [
91                    "<mcp_server.py-abs-path>"
92                ]
93            }
94        }
95    }   
96    ```
97 
982.  **Use the available tools**:
99    Ask Claude something like:
100    
101    - Create a Google Calendar Event based on the content of the last mail being sent to my inbox.
102      If you cannot create an event, create a sort of 'reminder event' in order to remind me to check that email.
103    
104    - Create a Google Docs drafting a trip plan in San Francisco.
105    
106    - Check what are my availabilities next week for a two-hours call with a customer.
107 
108    - Edit the start time of the meeting with the VCs to 10 A.M.
109 
110    - Search for new e-mails in my inbox talking about AI news.
111 
112    - Send an email to my supplier telling him he's late and I need the next lot as soon as possible.
113 
114    - Much more.
115 
116 
117## Roadmap & Future Plans
118 
119This server is the foundation for a much larger vision. The goal is to provide a comprehensive MCP server for the entire Google Workspace suite. Future additions will include tools for:
120 
121*   📝 **Google Docs**: More granular document manipulation, such as appending text or reading specific sections instead of overwriting the whole file.
122*   📊 **Google Sheets**: Read data from sheets, append new rows, update cells, and even perform calculations.
123*   📨 New functionalities for **Gmail**.
124*   📅 New functionalities for **Google Calendar**.
125*   🗂️ New functionalities for **Google Drive**.
126 
127Contributions are welcome!
128 
129## Contributing
130 
131If you'd like to contribute, please feel free to fork the repository and submit a pull request. For major changes, please open an issue first to discuss what you would like to change.
132 
133## License
134 
135This project is licensed under the MIT License. See the `LICENSE` file for details.
136