Google Tasks MCP Server

Bu MCP sunucusu Google Tasks ile entegre olarak görevleri listeleme, okuma, arama, oluşturma, güncelleme ve silme işlemlerine olanak tanır.

Bileşenler

Araçlar

• search

  • Google Tasks'ta görevleri ara
  • Input: query (string): Arama sorgusu
  • Eşleşen görevleri detaylarıyla döndürür

• list

  • Google Tasks'taki tüm görevleri listele
  • İsteğe bağlı input: cursor (string): Sayfalama için imleç
  • Tüm görevlerin listesini döndürür

• create

  • Google Tasks'ta yeni bir görev oluştur
  • Input:
    • taskListId (string, isteğe bağlı): Görev listesi ID'si
    • title (string, zorunlu): Görev başlığı
    • notes (string, isteğe bağlı): Görev notları
    • due (string, isteğe bağlı): Son tarih
  • Görev oluşturma onayını döndürür

• update

  • Google Tasks'taki mevcut bir görevi güncelle
  • Input:
    • taskListId (string, isteğe bağlı): Görev listesi ID'si
    • id (string, zorunlu): Görev ID'si
    • uri (string, zorunlu): Görev URI'ı
    • title (string, isteğe bağlı): Yeni görev başlığı
    • notes (string, isteğe bağlı): Yeni görev notları
    • status (string, isteğe bağlı): Yeni görev durumu ("needsAction" veya "completed")
    • due (string, isteğe bağlı): Yeni son tarih
  • Görev güncelleme onayını döndürür

• delete

  • Google Tasks'ta bir görevi sil
  • Input:
    • taskListId (string, zorunlu): Görev listesi ID'si
    • id (string, zorunlu): Görev ID'si
  • Görev silme onayını döndürür

• clear

  • Google Tasks görev listesinden tamamlanan görevleri temizle
  • Input: taskListId (string, zorunlu): Görev listesi ID'si
  • Temizlenen görevlerin onayını döndürür

Kaynaklar

Sunucu Google Tasks kaynaklarına erişim sağlar:

• Tasks (gtasks:///<task_id>)
  • Google Tasks'taki bireysel görevleri temsil eder
  • Başlık, durum, son tarih, notlar ve diğer metaverileri içeren görev detaylarının okunmasını destekler
  • Sağlanan araçlar kullanılarak listelenebilir, okunabilir, oluşturulabilir, güncellenebilir ve silinebilir

Başlangıç

1. Yeni bir Google Cloud projesi oluştur
2. Google Tasks API'ı etkinleştir
3. OAuth onay ekranını yapılandır (test için "internal" uygun)
4. https://www.googleapis.com/auth/tasks kapsamlarını ekle
5. OAuth Client ID oluştur "Desktop App" uygulama türü için
6. Client'ın OAuth anahtarlarının JSON dosyasını indir
7. Anahtar dosyasını gcp-oauth.keys.json olarak yeniden adlandır ve bu repo'nun root'una yerleştir (yani gcp-oauth.keys.json)

Sunucuyu npm run build veya npm run watch ile oluşturduğunuzdan emin olun.

Smithery Üzerinden Yükleme

Google Tasks Server'ı Claude Desktop'a Smithery aracılığıyla otomatik olarak yüklemek için:

npx -y @smithery/cli install @zcaceres/gtasks --client claude

Kimlik Doğrulama

Kimlik doğrulaması yapmak ve kimlik bilgilerini kaydetmek için:

1. Sunucuyu auth argümanı ile çalıştır: npm run start auth
2. Bu, sistem tarayıcınızda bir kimlik doğrulama akışı açacaktır
3. Kimlik doğrulama işlemini tamamla
4. Kimlik bilgileri bu repo'nun root'una kaydedilecek (yani .gdrive-server-credentials.json)

Desktop App ile Kullanım

Bu sunucuyu desktop app'le entegre etmek için, uygulamanızın sunucu yapılandırmasına aşağıdakini ekleyin:

{
  "mcpServers": {
    "gtasks": {
      "command": "/opt/homebrew/bin/node",
      "args": [
        "{ABSOLUTE PATH TO FILE HERE}/dist/index.js"
      ]
    }
  }
}