Google MCP Server

A comprehensive Model Context Protocol (MCP) server for Google integration, providing access to Google Calendar, Docs, Sheets, Slides, Drive, Gmail, Contacts, YouTube, Tasks, Forms, Chat, and Meet.

Features

Google Forms

• Create and manage Google Forms
• Add questions (multiple choice, short answer, checkboxes, etc.)
• Add page breaks, text items, images, and videos
• List and retrieve form responses
• Update form settings (quiz mode, etc.)

Google Chat

• List, create, and manage Chat spaces
• Send, update, and delete messages
• Add and remove reactions
• Manage space members
• Thread support for conversations

Google Meet

• Create meeting spaces with access controls
• Schedule meetings via Calendar integration
• Create instant meetings
• List and access conference records
• View participant information
• Access meeting recordings and transcripts

Google Calendar

• List calendars and events
• Create, update, and delete events
• Quick add events using natural language
• Get today's events and upcoming events
• Check free/busy availability

Google Gmail

• Read, search, and list emails
• Send emails and reply to threads, with file attachments
• List and download attachments on received messages
• Mark as read/unread, trash messages
• List labels and organize emails

Google Contacts (People API)

• List, search, and manage contacts
• Create, update, and delete contacts
• List contact groups

Google Drive

• List, search, and browse files and folders
• Upload, download, copy, move, and delete files, text or binary
• Replace the contents of an existing file
• Export Google Workspace files to other formats (PDF, DOCX, CSV, ...)
• Create folders
• Rename files

Google Docs

• Create new documents with optional initial content
• Read document content
• Insert and append text
• Find and replace text
• List all documents

Google Sheets

• Create spreadsheets with multiple sheets
• Read values from ranges
• Update and append values
• Clear ranges
• Add and delete sheets
• List all spreadsheets

Google Slides

• Create and manage presentations
• Add, delete, and duplicate slides
• Add text boxes and images
• Find and replace text
• List all presentations

Google YouTube

• Search videos, channels, and playlists
• Get video and channel details
• View and manage playlists
• Get video comments
• View subscriptions and liked videos
• Rate videos

Google Tasks (Keep Alternative)

• Manage task lists (similar to Keep categories)
• Create, update, complete, and delete tasks
• Tasks support notes/descriptions (similar to Keep notes)
• Convenience "notes" tools that provide Keep-like functionality

> Note: Google Keep does not have an official public API. This server uses Google Tasks API as an alternative, which provides similar note-taking capabilities through tasks with descriptions.

Installation

# Clone the repository
cd google-mcp

# Install dependencies
pnpm install

# Build the project
pnpm build

Google Cloud Setup

Before using this server, you need to set up Google Cloud credentials:

1. Create a Google Cloud Project

1. Go to Google Cloud Console

2. Create a new project or select an existing one

3. Enable the following APIs:

2. Create OAuth 2.0 Credentials

1. Navigate to APIs & Services > Credentials

2. Click Create Credentials > OAuth client ID

3. Select Desktop app as the application type

4. Download the JSON file

3. Place Credentials File

Save the downloaded JSON file as `credentials.json` at the appropriate location for your platform:

Linux:

~/.config/google-mcp/credentials.json

(or `$XDG_CONFIG_HOME/google-mcp/credentials.json` if XDG_CONFIG_HOME is set)

macOS:

~/Library/Application Support/google-mcp/credentials.json

Windows:

%APPDATA%\google-mcp\credentials.json

(typically `C:\Users\\AppData\Roaming\google-mcp\credentials.json`)

The file should look like:

{
  "installed": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "your-project-id",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:3000/oauth2callback"]
  }
}

Usage with MCP Clients

The server runs as a long-lived pooled worker, not as a stdio subprocess. It

exposes the current Streamable HTTP transport at `/mcp` and retains the legacy

HTTP+SSE transport at `/sse` plus `/messages` for older clients. Start the

worker once, then point clients at `/mcp`.

Start the worker:

node /path/to/google-mcp/dist/index.js
# or from the project directory:
pnpm dev

It listens on `127.0.0.1:3015` by default. Override with `GOOGLE_MCP_HOST` and

`GOOGLE_MCP_PORT` (or `PORT`).

Add to your MCP settings configuration:

{
  "mcpServers": {
    "google": {
      "url": "http://127.0.0.1:3015/mcp"
    }
  }
}

Every client that connects gets its own MCP session while sharing one

authenticated Google session, so you only complete the OAuth flow once no

matter how many clients or agents attach. Legacy SSE clients can continue to

use `http://127.0.0.1:3015/sse`.

Authentication

On first use, call the `google_auth` tool to initiate OAuth authentication:

1. The server will provide a URL to authenticate

2. Open the URL in a browser and sign in with your Google account

3. Grant the requested permissions

4. Authentication will complete automatically

Tokens are stored locally and will be refreshed automatically:

• Linux: `~/.local/share/google-mcp/tokens.json` (or `$XDG_DATA_HOME/google-mcp/`)
• macOS: `~/Library/Application Support/google-mcp/tokens.json`
• Windows: `%APPDATA%\google-mcp\tokens.json`

Local Files

Tools that read a local file (`path`) or write one (`savePath`) resolve every

path inside a single sandbox directory, defaulting to `~/Downloads/google-mcp`.

Relative paths are taken from that root; absolute paths must fall inside it.

This matters because the arguments come from a model that may have just read a

hostile email. Without a boundary, an injected "attach `~/.ssh/id_rsa`" is an

exfiltration primitive and an injected `savePath` of `~/.ssh/authorized_keys`

is code execution. Inside the sandbox both are inert.

export GOOGLE_MCP_FILE_ROOT="$HOME/Documents/mcp-files"

Regardless of the root, the server refuses to touch key and credential

directories (`.ssh`, `.aws`, `.gnupg`, ...) or files that look like secrets

(`*.pem`, `*.key`, `tokens.json`, `credentials.json`, `.env*`), does not follow

symlinks out of the root, and never overwrites an existing file.

Inline transfers are capped at 1 MB, since they land in the model's context;

pass `savePath` for anything larger, up to 25 MB.

Available Tools

Authentication

Google Calendar

Google Gmail

Google Contacts

Google Drive

Google Docs

Google Sheets

Google Slides

Google YouTube

Google Tasks

Notes (Keep-like)

Google Forms

Google Chat

Google Meet

Examples

Send an Email

Use gmail_send with to "recipient@example.com", subject "Hello", and body "This is a test email."

Create a Calendar Event

Use calendar_create_event with summary "Team Meeting", startDateTime "2025-01-15T10:00:00-05:00", and endDateTime "2025-01-15T11:00:00-05:00"

Search YouTube

Use youtube_search with query "MCP tutorial" and type "video"

Create a Google Doc

Use docs_create with title "Meeting Notes" and content "# Weekly Meeting\n\nAttendees: ..."

Read a Spreadsheet

Use sheets_read with spreadsheetId "abc123" and range "Sheet1!A1:D10"

Search Drive

Use drive_search with query "quarterly report"

Create a Note

Use notes_create with title "Shopping List" and content "- Milk\n- Eggs\n- Bread"

Create a Google Form

Use forms_create with title "Customer Survey" and description "Help us improve our service"

Send a Chat Message

Use chat_send_message with spaceName "spaces/AAAAA" and text "Hello team!"

Schedule a Google Meet

Use meet_schedule with summary "Team Standup", startTime "2025-01-15T09:00:00-05:00", and endTime "2025-01-15T09:30:00-05:00"

Development

# Run in development mode with hot reload
pnpm dev

# Build for production
pnpm build

# Run tests
pnpm test

License

MIT License - see LICENSE for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.