Google Workspace MCP Settings

Genel Bakış

Google Workspace MCP, Gmail, Calendar, Drive, Tasks gibi Google Workspace araçlarını AI destekli bir şekilde Kuika platformu üzerinden kontrol etmenizi sağlar.

Configuration Manager’da Google Workspace Setting Oluşturma

Kuika platformuna giriş yapın.
Apps ekranından çalışacağınız projeyi seçin.

Configuration Manager → App Settings → MCP → Google Workspace alanından ADD NEW butonuna tıklayın.

Gerekli Alanlar

Name → Ayar için belirleyeceğiniz ad.
Client ID → Google Cloud Console’dan alınır.
Client Secret → Google Cloud Console’dan alınır.
E-Mail Address → Kullanılacak Google hesabı adresi.
Search API Key → Google Cloud Console üzerinden oluşturulur.
Search Engine ID → Google Custom Search Engine üzerinden alınır.

Client ID ve Client Secret Oluşturma

Google Cloud Console adresine gidin.

Var olan bir proje seçin veya yeni proje oluşturun.

Sol menüden APIs & Services → Credentials bölümüne gidin.

Create Credentials → OAuth Client ID seçin.
Application Type → Web Application
Create butonuna basın.

Oluşturulan Client ID ve Client Secret değerlerini kopyalayarak Configuration Manager’a ekleyin.

Search API Key Oluşturma

Google Cloud Console → proje seçin.

APIs & Services → Library → Custom Search API aratın → Enable.

APIs & Services → Credentials → Create Credentials → API Key.
API Key oluşturulur → kopyalayın.

İsteğe bağlı olarak Edit API Key üzerinden:
- Application restrictions (web → referrer, server → IP, mobile → package id)
- API restrictions → Custom Search API seçin
Save ile kaydedin.

Configuration Manager – Önemli Uyarılar

Oluşturulmuş bir config setting sadece bir projede kullanılabilir. Başka projelerde kullanmak için yeniden oluşturulmalıdır.
Google Workspace’deki ilgili action’ları kullanabilmek için aşağıdaki API’lerin etkinleştirilmesi gerekir:

Google Calendar API
Google Drive API
Gmail API
Google Tasks API

Google Cloud Console ana sayfadayken üstteki arama kutusuna bu API isimlerini yazıp Enable etmeniz gerekmektedir.

Search Engine ID Oluşturma

Google CSE adresine gidin.

Get Started → Create.
Oluşturulduktan sonra verilen kod snippet içinde cx ile başlayan değer Search Engine ID’dir.

Yetkilendirme

Configuration Manager’da gerekli alanlar doldurulduktan sonra:

Create butonuna tıklayın. Google yetkilendirme ekranı açılır.

Oturum açıp izinleri verin.

Başarılı mesaj görüntülendikten sonra Configuration Manager ekranında Create butonuna tekrar basın.

İkinci tıklama, yetkilendirmenin doğrulanması için gereklidir.

Google Workspace Actions

Google Calendar

Calendar Create Event

Input

settings (Object – zorunlu): Config Manager’da Google Workspace için oluşturulmuş setting ayarı seçilir. Örn: workspace_setting_1
calendarId (String – zorunlu): Etkinliğin ekleneceği takvimin kimliği. Kullanıcının birincil takvimi için "primary" girilir. Farklı bir takvim için Google Takvim ID’si kullanılır (abcd1234@group.calendar.google.com).
summary (String – zorunlu): Etkinliğin başlığı veya kısa adı. Örn: "Proje Kickoff Toplantısı"
description (String – opsiyonel): Etkinliğin detaylı açıklaması. Örn: "Projenin başlangıç planlaması ve görev dağılımı yapılacak."
startDate (String – zorunlu): Etkinliğin başlangıç zamanı. ISO 8601 formatında. Örn: "2025-11-01T09:00:00+03:00"
endDate (String – zorunlu): Etkinliğin bitiş zamanı. ISO 8601 formatında. Örn: "2025-11-01T10:00:00+03:00"
timeZone (String – opsiyonel): Etkinliğin saat dilimi. Örn: "Europe/Istanbul"
location (String – opsiyonel): Etkinliğin yapılacağı yer. Örn: "Kuika Ofis – İstanbul"
attendees (Array – opsiyonel): Katılımcıların e-posta adresleri listesi. Örn: ["ahmet@example.com", "ayse@example.com"]
add_google_meet (Boolean – opsiyonel): true girildiğinde etkinliğe otomatik Google Meet linki eklenir.
use_default_reminders (Boolean – opsiyonel): true girildiğinde takvimin varsayılan hatırlatıcıları kullanılır.

Output

Başarılı mesaj döner → Etkinlik başarıyla oluşturulmuştur. Dönen bilgiler:

eventId (String): Etkinliğin benzersiz kimliği.
htmlLink (String): Google Calendar’da etkinliği açma linki.
status (String): "confirmed" → Etkinlik oluşturuldu.

Calendar Delete Event

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş Google Workspace setting.
calendarId (String – zorunlu): Etkinliğin bulunduğu takvimin kimliği. "primary" → Kullanıcının ana takvimi. abcd1234@group.calendar.google.com → Farklı takvim kimliği.
eventId (String – zorunlu): Silinecek etkinliğin benzersiz kimliği. eventId, Google Calendar List Events action’ı ile öğrenilebilir.

Output

Başarılı mesaj, etkinlik silinmiş olur.

Calendar List Calendar

Input

Settings: Configuration Manager’da oluşturulmuş Google Workspace setting.

Output

name (String): Takvimin adı.
id (String): Takvimin benzersiz kimliği.
is_primary (Boolean): Takvimin kullanıcının birincil takvimi olup olmadığını belirtir.

Calendar List Events

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş Google Workspace setting.
calendarId (String – zorunlu): Etkinliklerin listeleneceği takvim kimliği.
- "primary" → Kullanıcının ana takvimi.
- abcd1234@group.calendar.google.com → Diğer takvimler.
startDate (String – opsiyonel): Listelenecek etkinliklerin başlangıç tarihi/zamanı (ISO 8601).
- Örn: "2025-11-01T00:00:00+03:00"
endDate (String – opsiyonel): Listelenecek etkinliklerin bitiş tarihi/zamanı (ISO 8601).
- Örn: "2025-11-30T23:59:59+03:00"
resultCount (Integer – opsiyonel): Döndürülecek maksimum etkinlik sayısı.
- Örn: 10
query (String – opsiyonel): Etkinlik arama kelimesi veya filtre.
- Örn: "toplantı"

Output

title (String): Etkinliğin başlığı.
start (String): Etkinliğin başlangıç zamanı.
end (String): Etkinliğin bitiş zamanı.
id (String): Etkinliğin benzersiz kimliği.
link (String): Google Calendar’da etkinliği açma linki.

Google Drive

Drive Search Files

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturduğumuz setting ayarı seçilir.
query (String – opsiyonel): SQL benzeri sorgu dili ile dosya araması yapılır.
- Örn:
  - "name contains 'report'" → adı “report” içeren dosyaları getirir.
  - "mimeType='application/pdf'" → yalnızca PDF dosyalarını listeler.
  - "modifiedTime > '2025-01-01T12:00:00'" → belirtilen tarihten sonra değişen dosyaları getirir.
  - "trashed = false" → çöp kutusunda olmayan dosyaları listeler.
pageSize (Integer – opsiyonel): Tek seferde dönecek maksimum sonuç sayısı.
- Varsayılan: 100
- Maksimum: 1000

Output

id (String): Dosyanın Google Drive’daki benzersiz kimliği.
link (String): Dosyanın webViewLink veya webContentLink adresi.
mimeType (String): Dosyanın MIME türü (örn: "application/pdf", "application/vnd.google-apps.document").
modified (String): Dosyanın en son değiştirilme tarihi (ISO 8601).
name (String): Dosyanın Drive’da görünen adı.
size (Integer): Dosya boyutu (byte cinsinden).

Google Docs, Sheets, Slides gibi Drive-native dosyalarda genelde boş döner.

Drive Get File Content

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulan setting.
fileId (String – zorunlu): Dosyanın benzersiz kimliği.
fileId, Google Drive Search Files veya List Items action’ları ile öğrenilebilir.

Output

content (Binary/Text): Dosyanın içeriği.
- PDF / PNG / DOCX gibi dosyalar → binary (base64 veya stream).
- Google Docs / Sheets gibi native dosyalar → export formatına göre (text/plain, application/pdf).
id (String): Dosyanın Google Drive’daki kimliği.
link (String): Drive üzerindeki dosya linki.
mimeType (String): Dosya türünü belirten MIME tipi.
name (String): Dosyanın görünen adı.

Drive List Items

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş setting.
folderId (String – opsiyonel): Klasör kimliği.
- Boş bırakılırsa "root" → Ana dizindeki dosyalar listelenir.
driveId (String – opsiyonel): Paylaşılan sürücüler için kullanılır. Boş bırakılırsa "root" olarak ana dizin alınır.
pageSize (Integer – opsiyonel): Tek seferde dönecek maksimum sonuç sayısı.
- Varsayılan: 100
- Maksimum: 1000

Output

id (String): Dosya veya klasör kimliği.
link (String): Dosyanın Drive üzerindeki web URL’si.
mimeType (String): Dosya türü (örn: "application/vnd.google-apps.folder" klasör için).
modified (String): Dosyanın en son değiştirilme tarihi/zamanı.
name (String): Dosyanın/klasörün görünen adı.
size (Integer): Byte cinsinden boyut.

Klasörlerde genellikle null döner.

Drive Create File

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş setting.
fileName (String – zorunlu): Drive’da oluşturulacak dosyanın adı. Örn: "rapor.txt", "data.csv"
content (Binary/Base64 – opsiyonel): Dosyanın içeriği. Binary veya base64 encode edilmiş olabilir. Eğer Google Docs, Sheets gibi Drive-native dosya oluşturulacaksa içerik boş bırakılabilir.
folderId (String – opsiyonel): Dosyanın yükleneceği klasörün kimliği. Boş bırakılırsa "root" → Ana dizine kaydedilir.
mimeType (String – zorunlu): Dosya türünü belirten MIME tipi.
- text/plain → .txt dosyası
- text/csv → .csv dosyası
- application/json → .json dosyası
- application/vnd.google-apps.document → Google Docs
- application/vnd.google-apps.spreadsheet → Google Sheets

Output

Başarılı mesaj döner → Dosya başarıyla Drive’a yüklenmiştir. Dönen bilgiler:

id (String): Dosyanın benzersiz kimliği.
link (String): Dosyayı açma linki.
name (String): Dosyanın Drive’daki adı.
mimeType (String): Dosya türü.

Google Mail

Mail Send Message

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturduğumuz setting ayarı seçilir.
to (String – zorunlu): E-postanın gönderileceği alıcı ya da alıcılar. Birden fazla kişi varsa virgül ile ayrılır. Örn: "ahmet@example.com, ayse@example.com"
subject (String – zorunlu): Gönderilecek e-postanın konu başlığı. Örn: "Toplantı Hatırlatması"
body (String – zorunlu): E-postanın içeriği / mesaj metni. HTML veya düz metin olabilir. Örn: "Merhaba, toplantımız yarın saat 10:00’da gerçekleşecektir."
cc (String – opsiyonel): Bilgi amaçlı eklenen alıcılar. Virgül ile ayrılır. Örn: "veli@example.com, ali@example.com"
bcc (String – opsiyonel): Gizli kopya alıcıları. Virgül ile ayrılır. Örn: "yonetici@example.com"

Output

Başarılı mesaj, e-posta gönderilmiş olur.

Mail Search Message

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturduğumuz setting ayarı seçilir.
query (String – zorunlu): Gmail’in arama çubuğunda kullanılan sözdizimini destekler. Örn:
- "from:ahmet@example.com" → Ahmet’ten gelen e-postalar.
- "subject:rapor" → Konusunda “rapor” geçen e-postalar.
- "after:2025/01/01 before:2025/02/01" → 1 Ocak–1 Şubat 2025 arası e-postalar.
pageSize (Integer – opsiyonel): Tek seferde dönecek maksimum mesaj sayısı.
- Varsayılan: 100
- Maksimum: 500

Output

messageId (String): Mesajın benzersiz Gmail kimliği.
threadId (String): Mesajın ait olduğu konuşma zincirinin kimliği.
threadLink (String): Gmail web arayüzünde tüm konuşma zincirini açan link.
webLink (String): Gmail web arayüzünde tek mesajı açan link.

Mail Get Message Content Batch

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturulmuş setting ayarı seçilir.
messageIds (Array – zorunlu): İçeriği alınmak istenen mesajların benzersiz kimlikleri. messageIds, Google Mail Search Messages action’ı ile bulunabilir. Örn: ["1789a2bcf3", "199ab2c98d"]

Output

body (String): Mesajın içeriği (HTML veya düz metin).
from (String): Gönderenin e-posta adresi ve varsa adı. Örn: "Ahmet Yılmaz <ahmet@example.com>"
messageId (String): Gmail’deki mesajın benzersiz kimliği.
subject (String): Mesajın konu satırı.
webLink (String): Gmail web arayüzünde mesajı açma linki.

Mail Get Message Content

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş Google Workspace setting.
messageId (String – zorunlu): Gmail’deki mesajın benzersiz kimliği.
messageId, Google Mail Search Messages action’ı ile bulunabilir. Örn: "1789a2bcf3"

Output

body (String): Mesajın içeriği (HTML veya düz metin).
from (String): Gönderenin e-posta adresi ve varsa adı.
subject (String): Mesajın konu satırı.

Google Search

Search

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturulmuş setting seçilir.
query (String – zorunlu): Arama yapılacak ifade. Örn: "kuika platformu", "openai gpt-5", "weather istanbul"
count (Integer – opsiyonel): Kaç sonuç döneceğini belirler. Örn: 10
offset (Integer – opsiyonel): Sonuçların başlangıç noktasını ayarlar (sayfalama için). Örn: 20 (20. sonuçtan itibaren getirir)
safe (String – opsiyonel): Güvenli arama filtresi.
- "none" → Filtre kapalı, her türlü içerik gelebilir.
- "moderate" → Orta düzey filtre, çoğu yetişkin/şiddet içerik engellenir.
- "active" → Katı güvenli arama, hassas içerikler tamamen engellenir.
searchType (String – opsiyonel): Arama türü.
- "image" → Görsel arama
- "news" → Haber arama
- "video" → Video arama
- Boş bırakılırsa → Normal web araması yapılır.
siteSearch (String – opsiyonel): Aramanın belirli bir siteye odaklanmasını sağlar. Örn: "github.com", "docs.kuika.com"
siteSearchFilterType (String – opsiyonel): siteSearch parametresinin nasıl uygulanacağını belirler.
- "none" → siteSearch parametresi yokmuş gibi davranır.
- "include" → Sadece belirtilen siteden sonuç döner.
- "exclude" → Belirtilen site hariç tüm sitelerden sonuç döner.
fileType (String – opsiyonel): Belirli bir dosya türüne göre arama yapar. Örn: "pdf", "docx", "xlsx"
language (String – opsiyonel): Sonuçların dilini sınırlandırır. Örn: "en" (İngilizce), "tr" (Türkçe)
country (String – opsiyonel): Sonuçları ülkeye göre filtreler. Örn: "us", "tr", "de"

Output

metadata (Object): Arama sorgusu ile ilgili özet bilgiler.
query (String): Kullanıcının yaptığı arama sorgusu.
resultReturned (Integer): Bu çağrıda dönen sonuç sayısı.
searchEngineId (String): Kullanılan Custom Search Engine kimliği.
searchTime (Decimal): Aramanın kaç saniyede tamamlandığı.
showingFrom (Integer): Sonuçların başlangıç sırası (örn: 1).
showingTo (Integer): Sonuçların bitiş sırası (örn: 10).
totalResults (Integer): Arama motorunun bulduğu toplam sonuç sayısı.
results (Array): Arama sonuçlarının listesi. Her bir sonuç için:
index (Integer): Sonucun arama sonuçlarındaki sıra numarası.
snippet (String): Sonuca ait kısa açıklama/özet metin.
title (String): Sayfanın başlığı (<title> etiketi veya metadata).
type (String): Sonucun türü (örn: "webpage", "image", "video").
url (String): Sonucun tam bağlantısı.

Search Engine Info

Input

settings (Object – zorunlu): Configuration Manager’da Google Workspace için oluşturulmuş setting seçilir.

Output

Başarılı mesaj döner → Search Engine ile ilgili bilgiler geri gelir. Örn: Kullanılan cx değeri (Search Engine ID), arama izin verilen domainler, yapılandırma bilgileri.

Google Task

Task List Task List

‍

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulan Google Workspace setting.
pageToken (String – opsiyonel): Sonraki sayfayı almak için kullanılır (pagination).
pageSize (Integer – opsiyonel): Bir çağrıda dönecek maksimum task list sayısı.

Output

nextPageToken (String): Sonraki sayfa için token.
taskLists (Array): Görev listeleri. Her bir liste için:
- id (String): Görev listesinin benzersiz kimliği.
- name/title (String): Görev listesinin görünen adı.
- updated (String): Görev listesinin son güncellenme zamanı.

Task List Task

Input

settings (Object – zorunlu): Configuration Manager’da oluşturulmuş setting.
taskListId (String – zorunlu): Görevlerin alınacağı listenin kimliği.
pageToken (String – opsiyonel): Sayfalama için token.
pageSize (Integer – opsiyonel): Dönecek maksimum görev sayısı.
showDeleted (Boolean – opsiyonel): Silinmiş görevleri getirip getirmeyeceği.
showCompleted (Boolean – opsiyonel): Tamamlanmış görevleri dahil edip etmeyeceği.
showHidden (Boolean – opsiyonel): Gizli görevlerin gösterilip gösterilmeyeceği.
showAssigned (Boolean – opsiyonel): Atanmış görevleri dahil edip etmeyeceği.
startCompletedDate (String – opsiyonel): Bu tarihten sonra tamamlanan görevler.
showEndDate (String – opsiyonel): Bu tarihe kadar tamamlanan görevler.
startDueDate (String – opsiyonel): Bu tarihten sonra son tarihi olan görevler.
endDueDate (String – opsiyonel): Bu tarihe kadar son tarihi olan görevler.

Output

email (String): Görevlerin ait olduğu kullanıcı e-postası.
listId (String): Görev listesinin kimliği.
nextPageToken (String): Sonraki sayfa için token.
tasks (Array): Görevler listesi. Her bir görev için:
- id (String): Görev kimliği.
- title (String): Görev adı.
- notes (String): Görev açıklaması.
- status (String): Görev durumu (needsAction veya completed).
- due (String): Görevin son tarihi.
- completed (String): Tamamlanma tarihi.
- updated (String): Son güncelleme zamanı.