Google Workspace MCP Server

This is a Model Context Protocol (MCP) server that provides AI agents with tools to interact with Google Workspace services (Gmail and Google Docs).

Available Tools

• send_email: Send an email via Gmail (supports multiple recipients, CC, BCC, plain-text and HTML).
• append_google_doc: Append text to an existing Google Document.

Setup Instructions

1. Configure Environment Variables

Rename .env.example to .env and fill in your Google Cloud credentials.

GOOGLE_CLIENT_ID=your_client_id
GOOGLE_CLIENT_SECRET=your_client_secret
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth2callback
PORT=3000
TOKEN_PATH=tokens.json

2. Generate Authentication Tokens

Before starting the MCP server, you must grant it access to your Google account. Run the authentication script:

npm run auth

1. Click the link printed in your terminal.
2. Sign in with your Google account.
3. Grant the required permissions for Gmail and Google Docs.
4. The script will automatically generate tokens.json in your workspace.

3. Build the Server

Compile the TypeScript code:

npm run build

4. Connect to an MCP Client (e.g., Claude Desktop)

To use this server with Claude Desktop or another MCP client, configure the client to run the compiled index.js file. Add the following to your MCP client configuration file (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/build/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauth2callback",
        "TOKEN_PATH": "/absolute/path/to/mcp-server/tokens.json"
      }
    }
  }
}

Note: Ensure the TOKEN_PATH environment variable in the client config points to the absolute path of your generated tokens.json file.