Google MCP Remote

Name: Google MCP Remote
Author: vakharwalad23

@vakharwalad23

Repository

About Google MCP Remote

Collection of Google-native tools (e.g., Gmail, Calendar) for the MCP

#google #mcp #cloudflare #google-api #agents #cloudflare-workers #durable-objects #mcp-server #modelcontextprotocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-mcp-remote": {
      "command": "bun",
      "args": [
        "run",
        "deploy"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google MCP Remote?

Google MCP Remote is a Cloudflare Workers–based MCP (Model Context Protocol) server that provides Google API tools (Gmail, Calendar, Drive, Tasks, YouTube, Contacts) for use with AI clients like Claude or Cursor. It requires deploying your own instance to keep your Google account data secure.

How to use Google MCP Remote?

First, create a Google Cloud project and set up OAuth 2.0 credentials, then enable the required APIs. Deploy the server by cloning the repository, installing dependencies with Bun, configuring secrets (GOOGLE_OAUTH_CLIENT_ID, GOOGLE_OAUTH_CLIENT_SECRET, COOKIE_ENCRYPTION_KEY), creating a KV namespace, and running bun run deploy. Finally, configure your AI client by adding the server to its MCP configuration (e.g., claude_desktop_config.json) using the mcp-remote transport pointing to your deployment’s /sse endpoint.

Key features of Google MCP Remote

Send emails with multiple recipients (to, cc, bcc) and HTML content
List, read, draft, and delete Gmail emails; manage labels
Create, list, update, delete calendar events; find free time slots
Search, read content, create, update, delete, and share Drive files
Manage task lists and tasks (create, update, mark complete, delete)
Search YouTube videos and get detailed video info
List, search, and get details from Google Contacts

Use cases of Google MCP Remote

Send emails or manage inbox through an AI assistant like Claude
Schedule and query calendar events without leaving the chat interface
Search, read, and update Google Drive files via natural language commands
Create and manage tasks and task lists using AI-driven workflows
Search YouTube videos and retrieve contact information from Google Contacts

FAQ from Google MCP Remote

What APIs are supported?

Gmail, Calendar, Drive, Tasks, YouTube, and Contacts (via Google People API) are supported.

How do I deploy this server?

Clone the repository, install dependencies with Bun, set Google OAuth credentials and a cookie encryption key as Cloudflare secrets, create a KV namespace, update wrangler.jsonc, and run bun run deploy.

How do I configure Claude to use this MCP server?

Add to your claude_desktop_config.json (or mcp.json for Cursor) a server entry with command npx, args ["mcp-remote", "https://your-project.your-username.workers.dev/sse"].

Is it safe to use someone else's deployed instance?

No. The README warns: “Do not use someone else’s deployed instance of this server as it requires access to your Google account and personal data.” Always deploy your own instance.

How can I test the server locally before deploying?

Create a .dev.vars file with the required environment variables, run bun run dev for a local server (usually at http://localhost:8788), and test with bunx @modelcontextprotocol/inspector@latest.