Which integrations are available for this server?

Provides tools for sending templated emails through Gmail API with secure OAuth authentication Integrates with Google Calendar API for scheduling meetings, finding free time slots, creating and canceling events, along with Gmail integration for email confirmations Utilizes Google Cloud platform services including Calendar API and Gmail API for comprehensive scheduling and email functionality

How do I use Google MCP Router?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Google MCP Router schedule a 45-minute team sync with alex@example.com for tomorrow at 2pm" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Google MCP Router

A Google-only MCP (Model Context Protocol) Router for scheduling meetings and sending email confirmations.

Features

5 MCP Tools: time.resolve, calendar.find_free_slots, calendar.create_event, calendar.cancel_event, email.send
Policy Enforcement: Working hours, calendar allowlist, overlap prevention
OAuth Integration: Secure Google API authentication with PKCE
Idempotency: Prevents duplicate operations
Observability: Structured logging, Prometheus metrics, OpenTelemetry tracing

Quick Start

Prerequisites

Node.js ≥ 20
Redis (optional, falls back to in-memory store)
Google Cloud project with Calendar API and Gmail API enabled

Installation

Quick Setup (Recommended)

Windows:

setup.bat

Linux/Mac:

chmod +x setup.sh
./setup.sh

Manual Setup

Clone the repository:

git clone <repository-url>
cd google-mcp-router

Install dependencies:

npm install

Set up environment variables:

cp .env.example .env
# Edit .env with your configuration

Build the project:

npm run build

Start the server:

npm start

Environment Configuration

Create a .env file with the following variables:

NODE_ENV=staging
APP_PORT=8080
DEFAULT_TZ=America/Chicago
DEFAULT_MEETING_MIN=30
ALLOWLIST_CALENDAR_IDS=primary
WORK_HOURS_START=08:00
WORK_HOURS_END=18:00
WORK_DAYS=Mon,Tue,Wed,Thu,Fri
GOOGLE_CLIENT_ID=your_google_client_id_here
GOOGLE_CLIENT_SECRET=your_google_client_secret_here
GOOGLE_REDIRECT_URI=http://localhost:8080/oauth/google/callback
TOKEN_ENC_KEY=base64:your_base64_encryption_key_here
REDIS_URL=redis://localhost:6379
LOG_LEVEL=info
GMAIL_SENDER_EMAIL=assistant@yourdomain.com
GMAIL_SENDER_NAME=Thinh's Assistant

Google Cloud Setup

Create a Google Cloud project
Enable Calendar API and Gmail API
Create OAuth 2.0 credentials (Web application)
Set redirect URI to http://localhost:8080/oauth/google/callback
Configure OAuth scopes:
- https://www.googleapis.com/auth/calendar.events
- https://www.googleapis.com/auth/gmail.send

API Usage

Authentication

Visit /oauth/google/login to start OAuth flow
Complete Google authentication
You'll be redirected to /oauth/google/callback with tokens stored

Tool Execution

Execute MCP tools via POST requests:

# Resolve time expression
curl -X POST http://localhost:8080/mcp/tools/time.resolve \
  -H "Content-Type: application/json" \
  -d '{"input": "next Tuesday 3pm"}'

# Find free slots
curl -X POST http://localhost:8080/mcp/tools/calendar.find_free_slots \
  -H "Content-Type: application/json" \
  -d '{
    "window_start_iso": "2024-01-15T09:00:00-06:00",
    "window_end_iso": "2024-01-15T17:00:00-06:00",
    "duration_min": 30
  }'

# Create event
curl -X POST http://localhost:8080/mcp/tools/calendar.create_event \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Team Meeting",
    "start_iso": "2024-01-15T14:00:00-06:00",
    "end_iso": "2024-01-15T15:00:00-06:00",
    "attendees": [{"email": "colleague@example.com"}],
    "idempotency_key": "unique-key-123"
  }'

Available Tools

time.resolve - Parse natural language time expressions
calendar.find_free_slots - Find available time slots
calendar.create_event - Create calendar events
calendar.cancel_event - Cancel calendar events
email.send - Send templated emails

Development

Running in Development Mode

npm run dev

Running Tests

npm test
npm run test:coverage

Linting

npm run lint

Type Checking

npm run type-check

Architecture

src/
├── server.ts                 # Fastify server
├── mcp/
│   ├── index.ts             # MCP tool registry
│   ├── tools/               # Individual tool implementations
│   └── schemas/             # JSON schemas for validation
├── adapters/                # Google API adapters
├── policy/                   # Business rule enforcement
├── auth/                     # OAuth and token management
├── templates/                # Email templates
└── util/                     # Shared utilities

Security

OAuth 2.0 with PKCE for secure authentication
AES-256-GCM encryption for token storage
Policy enforcement for all operations
Input validation and sanitization
Rate limiting and idempotency

Monitoring

Health Check: GET /health
Metrics: GET /metrics (Prometheus format)
Logs: Structured JSON logging with Pino

License

MIT License

Google MCP Router

Google MCP Router

Features

Quick Start

Prerequisites

Installation

Quick Setup (Recommended)

Manual Setup

Environment Configuration

Google Cloud Setup

API Usage

Authentication

Tool Execution

Available Tools

Development

Running in Development Mode

Running Tests

Linting

Type Checking

Architecture

Security

Monitoring

License

Resources

Latest Blog Posts

MCP directory API