Google Workspace için kapsamlı MCP sunucusu, Google Calendar, Drive, Gmail, Docs, Forms, Chats, Slides ve Sheets desteğiyle stdio, Streamable HTTP ve SSE taşımaları üzerinde çalışır.
Claude Desktop config.json'a ekle
{
"mcpServers": {
"taylorwilsdon-google-workspace-mcp": {
"command": "python",
"args": [
"-m",
"google_workspace_mcp"
]
}
}
} Kaynak kodu al ve yerel olarak çalıştır
git clone https://github.com/taylorwilsdon/google_workspace_mcp.git ~/.mcp/google_workspace_mcp
cd ~/.mcp/google_workspace_mcp Google Calendar, Drive, Gmail, Docs, Sheets, Slides, Forms, Tasks, Contacts ve Chat üzerinde tüm MCP istemcileri, AI asistanları ve geliştirici araçları aracılığıyla doğal dil kontrolü.
Tüm MCP istemcileri, Claude Code ve Codex gibi araçlarla kullanım için eksiksiz özellikli CLI ve Kod Modu içerir!
En özellik açısından eksiksiz Google Workspace MCP sunucusu, Google'ın kendi araçlarının ve Claude ve ChatGPT ile yerleşik entegrasyonların yapamadığı şeyleri yapabilir. Uzaktan OAuth 2.1 çok kullanıcılı desteği, detaylı düzenleme araçları ve varolan herhangi bir Google Workspace aracının en kapsamlı kapsamı ile Workspace MCP ayrı bir sınıftadır. Yerel OAuth 2.1, durumsuz mod ve harici auth sunucusu desteği sunan, merkezi olarak ve güvenli bir şekilde tüm kuruluşunuz için barındırabileceğiniz tek Workspace MCP'dir!
|
⚡ Başlangıç Hızlı Başlangıç · Ön Koşullar Google Cloud · Kimlik Bilgileri |
🧰 Araçlar Tüm Araçlar · Araç Katmanları CLI · Sunucuyu Başlat |
🔌 Bağlan Hızlı Başlangıç · Claude Desktop Claude Code · VS Code · LM Studio |
🚀 Dağıt OAuth 2.1 · Durumsuz Harici OAuth · Ters Proxy |
📐 Geliştir Mimari · Geliş Kurulu Güvenlik · Lisans |
Uygulamada görmek:
Workspace MCP, tek en eksiksiz MCP sunucusu, tüm büyük Google Workspace hizmetlerini AI asistanları ve tüm ajan platformlarıyla entegre eden tek sunucudur. Tüm araç seti, yerel ve uzaktan örnekleri destekleyen CLI kullanımı için mevcuttur.
12 hizmet — Gmail · Drive · Calendar · Docs · Sheets · Slides · Forms · Chat · Apps Script · Tasks · Contacts · Arama
|
📧 Gmail — Eksiksiz e-posta yönetimi, uçtan uca kapsam |
⚡ Apps Script — Uygulamalar arası iş akışı otomasyonu ✅ Tasks — Hiyerarşi ile görev ve liste yönetimi 🔐 Kimlik Doğrulama ve Güvenlik |
|
Güvenlik Ekipleri İçin Bu sunucu, kimliği doğrulanmış kullanıcı adına kendi OAuth istemci kimlik bilgilerinizi kullanarak, hiçbir yere veri göndermez, Google API'lerine göndermez. Telemetri yoktur, kullanım raporu yoktur, analitik yoktur, lisans sunucusu yoktur ve SaaS bağımlılığı yoktur. Tüm veri yolu: altyapınız → Google API'leri.
|
Yasal ve Satın Alma İçin Bu proje MIT lisanslı — "açık çekirdek" değil, "kaynak mevcut" değil, "CLA ile ücretsiz" değil. Çift lisanslama, ticari katman özellik kapısı ve katkı lisans sözleşmesi yoktur.
Lisans 21 satırdır ve ne anlama geldiğini söyler. |
Kimlik bilgilerini ayarla → bir başlatma komutu seç → istemcinizi bağla
💡 Workspace MCP'de yeni misiniz? İnteraktif Hızlı Başlangıç Rehberini → adım adım kurulum, ekran görüntüleri ve sorun giderme ipuçlarıyla kontrol edin!
|
Gizli İstemci Hızlı Başlangıçı
|
Secretless / Genel OAuth 2.1 (PKCE) Hızlı Başlangıçı
|
Kimlik bilgisi kurulumu → · Tüm başlatma seçenekleri → · Katman ayrıntıları →
| Değişken | Amaç | |
|---|---|---|
| 🔐 Kimlik Doğrulama | ||
GOOGLE_OAUTH_CLIENT_ID |
gerekli | Google Cloud'dan OAuth istemci kimliği |
GOOGLE_OAUTH_CLIENT_SECRET |
Gizli istemciler için OAuth istemci parolası; genel OAuth 2.1 PKCE istemcileri için isteğe bağlı | |
OAUTHLIB_INSECURE_TRANSPORT |
gerekli* | Geliştirme için 1 olarak ayarla — http:// yönlendirmesine izin ver |
USER_GOOGLE_EMAIL |
Tek kullanıcılı auth için varsayılan e-posta | |
GOOGLE_CLIENT_SECRET_PATH |
client_secret.json özel yolu |
|
GOOGLE_MCP_CREDENTIALS_DIR |
Kimlik bilgisi dizini — varsayılan ~/.google_workspace_mcp/credentials |
|
| 🖥️ Sunucu | ||
WORKSPACE_MCP_BASE_URI |
Temel sunucu URI'si (port yok) — varsayılan http://localhost |
|
WORKSPACE_MCP_PORT |
Dinleme portu — varsayılan 8000. OAuth geri çağrısı portunu da kontrol eder. PORT env değişkeni ayarlanırsa öncelik alır. |
|
WORKSPACE_MCP_HOST |
Bağlama ana bilgisayarı — varsayılan 0.0.0.0 |
|
WORKSPACE_MCP_TRANSPORT |
stdio veya streamable-http; --transport iletilmediğinde kullanılır |
|
WORKSPACE_MCP_HTTP_PORT |
Gelişmiş eski stdio yardımcı /mcp portu yerel workspace-cli erişimi için. Boş olduğunda devre dışı. Yalnızca 127.0.0.1 ile bağlanır ve yerel işlemlere erişilebilir. |
|
WORKSPACE_EXTERNAL_URL |
Ters proxy kurulumları için harici URL | |
WORKSPACE_ATTACHMENT_DIR |
İndirilen ekler dizini ve varsayılan güvenilir yerel ek dizini — varsayılan ~/.workspace-mcp/attachments/ |
|
WORKSPACE_MCP_URL |
CLI için uzaktan MCP uç noktası URL'si | |
ALLOWED_FILE_DIRS |
Yerel dosya okumaları için iki nokta üstü üste ayrılmış beyaz liste | |
| 🧰 Araç Seçimi | ||
WORKSPACE_MCP_TOOLS |
Virgülle ayrılmış hizmetler, örn. gmail,drive,calendar; boş tüm hizmetleri ifade eder |
|
WORKSPACE_MCP_TOOL_TIER |
core, extended veya complete; boş tüm araçları ifade eder |
|
WORKSPACE_MCP_READ_ONLY |
Salt okunur kapsamları talep etmek ve yazma araçlarını filtrelemek için true, 1 veya yes |
|
WORKSPACE_MCP_PERMISSIONS |
Alan ayrılmış service:level girdileri, örn. gmail:send drive:full; araçlar ve salt okunur ile karşılıklı olarak münhasır |
|
| 🔑 OAuth 2.1 ve Çok Kullanıcılı | ||
MCP_ENABLE_OAUTH21 |
OAuth 2.1 çok kullanıcılı desteğini etkinleştirmek için true |
|
EXTERNAL_OAUTH21_PROVIDER |
Taşıyıcı belirteçleri ile harici OAuth akışı için true |
|
WORKSPACE_MCP_STATELESS_MODE |
Durumsuz konteyner dostu işletim için true |
|
GOOGLE_OAUTH_REDIRECT_URI |
OAuth geri çağrısı URL'sini geçersiz kıl — varsayılan otomatik oluşturma | |
OAUTH_CUSTOM_REDIRECT_URIS |
Virgülle ayrılmış ek yönlendirme URI'leri | |
OAUTH_ALLOWED_ORIGINS |
Virgülle ayrılmış ek CORS kaynakları | |
WORKSPACE_MCP_OAUTH_PROXY_STORAGE_BACKEND |
memory, disk veya valkey — depolama arka uçlarına bakın |
|
FASTMCP_SERVER_AUTH_GOOGLE_JWT_SIGNING_KEY |
OAuth proxy depolama için özel şifreleme anahtarı; genel OAuth 2.1 istemcileri için GOOGLE_OAUTH_CLIENT_SECRET atlanırken gerekli |
|
WORKSPACE_MCP_ALLOWED_CLIENT_REDIRECT_URIS |
Dinamik olarak kayıtlı OAuth istemcilerinin kullanabileceği yönlendirme URI'lerinin virgülle ayrılmış beyaz listesi. Varsayılan ayarlanmamıştır (DCR başına herhangi bir URI izin verilir). FastMCP'nin glob desenlerini destekler (*, *.example.com) |
|
| 🗄️ Kimlik Bilgisi Deposu | ||
WORKSPACE_MCP_CREDENTIAL_STORE_BACKEND |
local_directory (varsayılan) veya gcs — kimlik bilgisi deposu sistemine bakın |
|
WORKSPACE_MCP_CREDENTIALS_DIR |
local_directory arka ucu için dizin |
|
GOOGLE_MCP_CREDENTIALS_DIR |
WORKSPACE_MCP_CREDENTIALS_DIR için geri uyumlu takma ad |
|
WORKSPACE_MCP_GCS_BUCKET |
Arka uç gcs olduğunda gerekli — GCS demet adı |
|
WORKSPACE_MCP_GCS_PREFIX |
gcs arka ucu için isteğe bağlı nesne adı ön eki |
|
WORKSPACE_MCP_GCS_REQUIRE_CMEK |
Başlangıçta bir demet varsayılan KMS anahtarını gerektirmek için true (ayarlanmamışsa hızlı başarısız) |
|
| 🔧 Hizmet Hesabı | ||
GOOGLE_SERVICE_ACCOUNT_KEY_FILE |
Hizmet hesabı JSON anahtar dosyasının yolu (etki alanı genelinde delegasyon) | |
GOOGLE_SERVICE_ACCOUNT_KEY_JSON |
Satır içi hizmet hesabı JSON anahtarı (dosyaya alternatif) | |
DWD_ALLOWED_DOMAINS |
İstek başına kimliğe bürünme için virgülle ayrılmış etki alanı beyaz listesi (isteğe bağlı) | |
| 🔍 Özel Arama | ||
GOOGLE_PSE_API_KEY |
Programlanabilir Arama Motoru için API anahtarı | |
GOOGLE_PSE_ENGINE_ID |
PSE için Arama Motoru Kimliği |
*Yalnızca geliştirme için gerekli. Claude Desktop, kimlik bilgilerini OS anahtarlığında güvenli bir şekilde depolar — bunları uzantı panelinde bir kez ayarla.
Önerilen kurulum, bir örneği çalıştırmak ve Claude'u buna bir Bağlayıcı aracılığıyla bağlamaktır. Tam talimatlar workspacemcp.com/quick-start adresindedir.
Python 3.10+ · uv/uvx · OAuth 2.0 kimlik bilgileri olan Google Cloud Projesi
GCS kimlik bilgisi deposu arka ucunu istiyorsanız, önce isteğe bağlı bağımlılığı yükleyin:
uv sync --extra gcs
# veya
pip install "workspace-mcp[gcs]"
Proje Oluştur — Konsolu Aç → → Yeni proje oluştur
OAuth Kimlik Bilgileri Oluştur — API'ler ve Hizmetler → Kimlik Bilgileri → Kimlik Bilgileri Oluştur → OAuth İstemci Kimliği
API'leri Etkinleştir — API'ler ve Hizmetler → Kitaplık, ardından her hizmeti etkinleştir:
| Calendar | Drive | Gmail | Docs |
| Sheets | Slides | Forms | Tasks |
| Chat | People | Özel Arama | Apps Script |
Kimlik Bilgilerini Ayarla — yukarıdaki Ortam Değişkeni Başvurusuna bakın veya:
export GOOGLE_OAUTH_CLIENT_ID="sizin-istemci-kimliğiniz"
export GOOGLE_OAUTH_CLIENT_SECRET="sizin-parolanız"
Genel OAuth 2.1 PKCE istemcileri için GOOGLE_OAUTH_CLIENT_SECRET atlanır ve bunun yerine FASTMCP_SERVER_AUTH_GOOGLE_JWT_SIGNING_KEY ayarlanır.
Tam OAuth belgeleri → · Kimlik bilgisi kurulum ayrıntıları →
|
1. Arama Motoru Oluştur
|
2. API Anahtarını Al
|
3. Değişkenleri Ayarla
Ortamda yapılandır |
≡ Hızlı Kurulum Kılavuzu ← Adım adım talimatlarTam Kurulum Süreci:
Benzer MCP sunucuları MarkusPfundstein/mcp-gsuite Workplace & Productivity Gmail ve Google Calendar ile entegrasyon. MarkusPfundstein/mcp-gsuite ★ 487 vasylenko/bear-notes-mcp Workplace & Productivity Bear Notes'u Claude'dan doğrudan arayabilir, okuyabilir, oluşturabilir ve güncelleyebilirsiniz. Tamamen lokal ve tam gizlilik ile çalışır. vasylenko/bear-notes-mcp ★ 199 takumi0706/google-calendar-mcp Workplace & Productivity Google Calendar API ile entegre olmayı sağlayan TypeScript tabanlı MCP sunucusu. takumi0706/google-calendar-mcp ★ 57 | ||