google-mcp-remote
by vakharwalad23·★ 14·Score 41
Cloudflare Workers-based MCP server providing Google API tools (Gmail, Calendar, Drive, etc.) for AI clients.
Overview
Google MCP Remote is a comprehensive implementation of the Model Context Protocol that enables AI clients like Claude or Cursor to interact with Google services through API tools. The server supports a wide range of Google applications including Gmail for email management, Calendar for scheduling, Drive for file operations, Tasks for task management, YouTube for video searches, and Contacts for contact management. It uses OAuth 2.0 authentication to securely access user data while maintaining privacy through self-hosted deployment.
Try asking AI
After installing, here are 6 things you can ask your AI assistant:
When to choose this
Choose this server if you need AI access to Google services like Gmail, Calendar, Drive, Tasks, YouTube and Contacts, especially when you want a serverless deployment solution without managing your own infrastructure.
When NOT to choose this
Avoid this if you need access to Google services not covered by this server, if you prefer self-hosted solutions over Cloudflare Workers, or if you have concerns about vendor lock-in to Cloudflare's ecosystem.
Tools this server exposes
12 tools extracted from the READMEsend_emailSend emails with multiple recipients and HTML content
list_emailsList emails with custom queries, labels, and result limits
read_emailRead a specific email by ID
create_calendar_eventCreate calendar events with details like summary, start/end time, and attendees
list_calendar_eventsList upcoming events with customizable filters
find_free_timeFind free time slots for scheduling
search_drive_filesFilter and sort Drive files with search queries
read_drive_fileRead file content from Drive (text, docs, spreadsheets)
create_drive_fileCreate new files in Drive with specified content
create_taskCreate tasks with title, notes, and due dates
list_tasksList tasks with filters
search_youtubeSearch for videos with customizable parameters
Comparable tools
Installation
Installation
Prerequisites
- Create a Google Cloud Project and set up OAuth 2.0 credentials
- Enable required APIs (Gmail, Calendar, Drive, Tasks, YouTube, People/Contacts)
- Add authorized JavaScript origins and redirect URIs
- Sign up for Cloudflare account and install Wrangler CLI
Deployment Steps
- Clone the repository:
git clone https://github.com/vakharwalad23/google-mcp-remote.git - Install dependencies:
bun install - Configure secrets:
wrangler secret put GOOGLE_OAUTH_CLIENT_IDand other secrets - Create KV namespace:
wrangler kv:namespace create OAUTH_KV - Deploy:
bun run deploy
Claude Configuration
{
"mcpServers": {
"google-mcp-remote": {
"command": "npx",
"args": [
"mcp-remote",
"https://your-project.your-username.workers.dev/sse"
]
}
}
}FAQ
- Is it safe to use this MCP server?
- The security warning clearly states not to use someone else's deployed instance as it requires access to your Google account. Always deploy your own instance to maintain control over your data and API access.
- Can I test the server without deploying it?
- Yes, you can test locally by creating a `.dev.vars` file with environment variables and running `bun run dev`. You can also test with MCP Inspector using `bunx @modelcontextprotocol/inspector@latest`.
Compare google-mcp-remote with
Last updated · Auto-generated from public README + GitHub signals.