boonkgim

MCP Google Contacts — DevOps skill for Claude Code

DevOps community

Remote MCP server for Google Contacts on Cloudflare Workers, for use as a claude.ai custom connector.

How to install MCP Google Contacts

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

What MCP Google Contacts does

Remote MCP server for Google Contacts 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 ★
MCP Boilerplate — A remote Cloudflare MCP server boilerplate with user authentication and Stripe for paid tools 1k ★
Workers MCP — Talk to a Cloudflare Worker from Claude Desktop 646 ★

README

mcp-google-contacts

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

A remote MCP server for Google Contacts, deployed on Cloudflare Workers, for use as a **custom connector in claude.ai** (web/desktop/mobile). Each user who connects authorizes their own Google account via OAuth — the server proxies that OAuth flow and never sees your Google password, just the tokens it needs to call the People API on your behalf.

Built for a specific workflow: send Claude a photo of a namecard/business card and have it extract the details and save a new contact for you.

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 per authorized user.
google-handler.ts — a small Hono app that owns /authorize and /callback: shows the consent screen, redirects to Google, exchanges the code for tokens, and stores the Google refresh token in props.
agents' McpAgent — a Durable Object-backed MCP server. Tool calls read this.props.googleRefreshToken and mint a fresh Google access token on demand (cached in-memory per Worker isolate) before calling the People API.
workers-oauth-utils.ts — CSRF/session/approval-dialog plumbing, copied near-verbatim from Cloudflare's reference OAuth demo (provider-agnostic).

Tools

create_contact — create a contact (name, company, title, emails, phones, address, notes)
search_contacts — search existing contacts by name/email/phone/company (use before creating, to avoid duplicates)
list_contacts — list contacts, most recently modified first
get_contact — fetch full details for one contact
update_contact — update fields on an existing conta