google-mcp
google-mcp
Multi-Account-Google-MCP-Server, der Gmail- und Kalender-Lesetools über stdio bereitstellt.
Sicherheitshinweise
credentials.jsonist nur lokal vorhanden und darf niemals committet werden.Kopieren Sie
credentials.template.jsonnachcredentials.jsonund füllen Sie es mit Ihren lokalen OAuth-Client-Werten aus.Refresh-Tokens werden in Ihrem OS-Keychain (
keyring) gespeichert, nicht in der Versionsverwaltung.
Related MCP server: gmail-mcp
Einrichtung
Abhängigkeiten installieren:
uv sync
Lokale OAuth-Client-Konfiguration erstellen:
cp credentials.template.json credentials.json
Erwartete Konto-E-Mails festlegen (optional, aber für Sicherheitsüberprüfungen bei der Authentifizierung empfohlen):
export GOOGLE_MCP_PERSONAL_EMAIL="you@example.com"export GOOGLE_MCP_WORK_EMAIL="you@company.com"
Optional einen spezifischen Arbeitskalender-Filter festlegen:
export GOOGLE_MCP_WORK_CALENDAR="calendar-id-or-summary"
Jedes Konto autorisieren:
uv run auth_setup.py personaluv run auth_setup.py work
Server ausführen
uv run server.py
Integrationstests
Diese greifen auf echte Google-APIs zu.
Einfache Live-Tests:
RUN_LIVE_TESTS=1 uv run integration_smoke.py
Inklusive destruktivem Keychain-Mutationstest:
RUN_LIVE_TESTS=1 RUN_DESTRUCTIVE_TESTS=1 uv run integration_smoke.py
Sicherheitsüberprüfungen bei der Veröffentlichung
Lokale Sicherheits-Guardrails ausführen:
python scripts/security_check.py
Optionale Pre-Commit-Integration:
uv tool install pre-commitpre-commit installpre-commit run --all-files
CI führt dasselbe Skript bei jedem Push/PR über
.github/workflows/security-check.ymlaus.
Available Tools
4 toolscalendar_events_personalC
List events for the configured personal account calendars.
Inputs: time_min (required), time_max (required), max_results. Returns: object
calendar_events_workC
List events for the configured work account calendars.
Inputs: time_min (required), time_max (required), max_results. Returns: object
gmail_search_personalB
Search Gmail for the configured personal account.
Inputs: query (required), max_results. Returns: object
gmail_search_workC
Search Gmail for the configured work account.
Inputs: query (required), max_results. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a unique combination of service (calendar vs gmail) and account type (personal vs work), making it impossible to confuse one tool with another.
All tools follow a strict pattern: {service}_{action}_{account}, using snake_case consistently. This makes the naming predictable and easy to understand.
With 4 tools, the count is appropriate for a focused server that distinguishes between two services across two accounts, avoiding unnecessary complexity.
The tool set covers listing events and searching emails, but is limited to these read operations. Missing capabilities like creating or modifying events/schedules are notable gaps for a full Google workspace integration.
Related MCP Connectors
Streamable HTTP MCP server for Google Calendar and Sheets with OAuth login.
Your Gmail, Calendar, Drive, GitHub, Oura, wallet and confirmed profile facts in any MCP client.
MCP server for Nylas — read email, calendars, events and contacts, and send email or create events.
Hosted email MCP for your own Gmail, Outlook.com, Microsoft 365, iCloud or IMAP inbox: read, search, draft, reply in thread, forward and file mail. It moves or flags up to 500 messages in one call, and a send leaves exactly one copy in Sent. A calendar is a separate connection, and connecting one adds diary and scheduling tools.
Related MCP Servers
- AlicenseAqualityCmaintenanceLocal-first Gmail MCP server using PKCE + loopback OAuth flow that stores refresh tokens in the OS keychain, enabling secure read/write Gmail access via MCP tools without tokens leaving the device.20MIT
- FlicenseNot gradedqualityDmaintenanceMulti-account Gmail MCP server for reading threads, managing labels, and creating drafts across multiple Gmail accounts.-
- AlicenseNot gradedqualityDmaintenanceA local MCP server that manages multiple Gmail accounts simultaneously, allowing MCP clients to switch between accounts per request without logging out or in. It securely stores OAuth tokens in the macOS Keychain.MIT
- AlicenseNot gradedqualityDmaintenanceA self-hostable Gmail MCP server that enables Gmail search/read, sending, replies, drafts, labels, and attachment downloads via MCP tools with OAuth authorization. Supports stdio and streamable HTTP transports.MIT