Google Workspace MCP Server

This project is an MCP (Model Context Protocol) server that provides tools to interact with Gmail and Google Docs.

Prerequisites

1. Python 3.10+
2. Google Cloud Project: You need to create a project in the Google Cloud Console and enable the Gmail and Google Docs APIs.

Setting up Google Cloud Credentials

1. Go to the Google Cloud Console.
2. Create a new project.
3. Go to APIs & Services > Library.
4. Search for and enable Gmail API and Google Docs API.
5. Go to APIs & Services > OAuth consent screen.
   • Choose External (or Internal if you have a Google Workspace org).
   • Fill in the required app information.
   • Add the following scopes:
     • https://www.googleapis.com/auth/gmail.modify
     • https://www.googleapis.com/auth/documents
   • Add your Google email address as a Test user.
6. Go to APIs & Services > Credentials.
7. Click Create Credentials > OAuth client ID.
8. Choose Desktop app as the application type.
9. Click Create and then Download JSON.
10. Rename the downloaded file to credentials.json and place it in the root directory of this project.

Installation

It is recommended to use a virtual environment.

python -m venv venv
# On Windows:
venv\Scripts\activate
# On macOS/Linux:
source venv/bin/activate

pip install -r requirements.txt

Running the Server

To start the MCP server, use the mcp CLI tool (installed via dependencies):

mcp dev main.py

The first time you run this, a browser window will open asking you to log in with your Google account and grant permissions to the app. After granting permissions, a token.json file will be created locally to store your access and refresh tokens.

Available Tools

The following tools will be exposed to your LLM:

• search_emails(query, max_results): Search for emails matching a Gmail query.
• read_email(message_id): Read the content of a specific email.
• send_email(to, subject, body): Send an email.
• read_document(document_id): Read the text content of a Google Doc.
• create_document(title, content): Create a new Google Doc with optional initial content.