boonkgim

MCP Gmail Multi Account — DevOps skill for Claude Code

DevOps community

Remote MCP server for Gmail with support for multiple connected accounts, deployed on Cloudflare Workers, for use as a claude.ai custom connector.

How to install MCP Gmail Multi Account

This entry records only its repository, not the path inside it, so there is no exact command to give. Open boonkgim/mcp-gmail-multi-account and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What MCP Gmail Multi Account does

Remote MCP server for Gmail with support for multiple connected accounts, deployed on Cloudflare Workers, for use as a claude.ai custom connector.

Alternatives in DevOps

Cloudflare Deploy — Deploy apps to Cloudflare using Workers, Pages, and platform services 14.6k ★
Cccc — Coordinate your coding agents like a group chat — read receipts, delivery tracking, and remote ops from your p 1.1k ★
MCP Boilerplate — A remote Cloudflare MCP server boilerplate with user authentication and Stripe for paid tools 1k ★

README

mcp-gmail-multi-account

[![CI](https://github.com/boonkgim/mcp-gmail-multi-account/actions/workflows/ci.yml/badge.svg)](https://github.com/boonkgim/mcp-gmail-multi-account/actions/workflows/ci.yml) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

A remote MCP server for Gmail, deployed on Cloudflare Workers, for use as a **custom connector in claude.ai** (web/desktop/mobile) — built because the official Gmail connector only supports one account at a time. This one lets a single connector authorization manage **any number of connected Gmail accounts** (personal, work, side project, ...), with tools that let Claude pick which account to act on.

Each user who connects authorizes their own Google account(s) via OAuth — the server proxies that OAuth flow and never sees your Google password, just the refresh tokens it needs to call the Gmail API on your behalf.

**Setting this up with an AI coding agent?** Clone the repo and just ask it (e.g. "help me set up this MCP server") — it can run the `npm`/ `wrangler` commands below and edit `wrangler.jsonc` itself. See [AGENTS.md](AGENTS.md) for exactly what it can automate versus what needs you in a browser (the Google Cloud Console steps and the claude.ai connector step).

Architecture

@cloudflare/workers-oauth-provider — implements the OAuth 2.1 server that claude.ai talks to (authorize/token/dynamic client registration), and hands your Worker an encrypted props bag identifying the connector owner (email + name) once per authorized Claude session.
google-handler.ts — a small Hono app that owns /authorize and /callback: shows the consent screen, redirects to Google, exchanges the code for tokens. The first Google account signed in here both establishes the owner's identity and is registered as their first connected Gmail account.
accounts.ts — the multi-account store. Connected Gmail accounts (email + refresh token) are kept in