grahac

grahac / google-mcp

Public

Gmail + Google Calendar MCP server for Claude. Works with any Google account — OAuth2 refresh tokens, no gcloud required.

56
0
100% credibility
Found Apr 24, 2026 at 56 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
JavaScript
AI Summary

A minimal Node.js MCP server enabling Claude AI to access Gmail and Google Calendar via OAuth2 refresh tokens stored locally, with support for multiple accounts and no external dependencies.

How It Works

1
🔍 Discover the helper

You find a simple tool that lets your AI assistant Claude check and manage your Gmail emails and Google Calendar events for you.

2
🌐 Set up Google permissions

Visit the Google Cloud website, create a quick project, turn on email and calendar access, and download a permission file for your personal use.

3
📱 Authorize your account

Run the easy setup program with your permission file, let it open your browser to log in to Google, and grant access safely.

4
✨ Connect multiple accounts

Add as many of your Google accounts as you want, and everything gets saved securely in one spot on your computer.

5
Link to your AI
💻
Claude Code or editor

Use a simple command or settings menu to point Claude to your connection.

🖥️
Claude Desktop app

Edit a settings file in the app folder to include your connection details.

6
📧 Start using it

Tell Claude to search your emails, read messages, create drafts, list events, or get event details, picking an account if needed.

🎉 AI handles your inbox and schedule

Now your AI assistant seamlessly manages your emails and calendar, saving you time every day.

Sign up to see the full architecture

5 more

Sign Up Free

Star Growth

See how this repo grew from 56 to 56 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is google-mcp?

google-mcp is a Node.js MCP server that plugs Gmail and Google Calendar into Claude AI, letting you search emails, read messages, create drafts, list events, and fetch calendar details via natural language prompts. It solves the hassle of OAuth setup for AI tools by using refresh tokens stored locally—no gcloud CLI, npm installs, or SDKs needed, just Node 18+. Works with any Google account, including Workspace or personal gmail google konto, and handles multiple github gmail accounts in one config file.

Why is it gaining traction?

Unlike bloated Google SDKs, it runs dependency-free with pure Node stdlib, making it ideal for sandboxed apps like Claude Desktop. Multi-account support shines for devs juggling personal and work inboxes—specify account per call or via env var. Tools like gmail_search with standard queries act as a github gmail checker or list, pulling headers and snippets fast, no extra auth loops.

Who should use this?

Claude power users querying unread emails across accounts, like "search alice@gmail.com for invoices." Devs building AI agents for gmail github filters, recovery, or cleaning inboxes without custom OAuth flows. Suited for solo makers or teams on Google Workspace needing quick calendar lookups in prompts.

Verdict

Grab it if you're deep in Claude workflows—setup takes 5 minutes, docs are solid for a 56-star repo. Low 1.0% credibility score flags early maturity and no tests, so test tokens thoroughly before production.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.