gtasks-mcp - Serveur de Protocole de Contexte de Modèle Google Tasks

Aperçu du Projet

gtasks-mcp est un serveur de Protocole de Contexte de Modèle (MCP) Google Tasks conçu spécifiquement pour Claude AI. Ce projet permet à Claude de s'intégrer directement avec l'API Google Tasks, offrant une gestion complète des tâches Google.

Adresse du projet : https://github.com/zcaceres/gtasks-mcp

Fonctionnalités Principales

Outils (Tools)

1. search - Rechercher une tâche

• Description de la fonction : Rechercher des tâches dans Google Tasks
• Paramètres d'entrée :
  • query (string) : Chaîne de requête de recherche
• Résultats retournés : Informations détaillées sur les tâches correspondantes

2. list - Lister les tâches

• Description de la fonction : Lister toutes les tâches dans Google Tasks
• Paramètres d'entrée :
  • cursor (string, optionnel) : Curseur de pagination
• Résultats retournés : Liste de toutes les tâches

3. create - Créer une tâche

• Description de la fonction : Créer une nouvelle tâche dans Google Tasks
• Paramètres d'entrée :
  • taskListId (string, optionnel) : ID de la liste de tâches
  • title (string, requis) : Titre de la tâche
  • notes (string, optionnel) : Notes de la tâche
  • due (string, optionnel) : Date d'échéance
• Résultats retournés : Confirmation de la création de la tâche

4. update - Mettre à jour une tâche

• Description de la fonction : Mettre à jour une tâche Google Tasks existante
• Paramètres d'entrée :
  • taskListId (string, optionnel) : ID de la liste de tâches
  • id (string, requis) : ID de la tâche
  • uri (string, requis) : URI de la tâche
  • title (string, optionnel) : Nouveau titre de la tâche
  • notes (string, optionnel) : Nouvelles notes de la tâche
  • status (string, optionnel) : Nouveau statut de la tâche ("needsAction" ou "completed")
  • due (string, optionnel) : Nouvelle date d'échéance
• Résultats retournés : Confirmation de la mise à jour de la tâche

5. delete - Supprimer une tâche

• Description de la fonction : Supprimer une tâche dans Google Tasks
• Paramètres d'entrée :
  • taskListId (string, requis) : ID de la liste de tâches
  • id (string, requis) : ID de la tâche
• Résultats retournés : Confirmation de la suppression de la tâche

6. clear - Effacer les tâches terminées

• Description de la fonction : Effacer les tâches terminées dans une liste de tâches Google Tasks
• Paramètres d'entrée :
  • taskListId (string, requis) : ID de la liste de tâches
• Résultats retournés : Confirmation de l'opération d'effacement

Ressources (Resources)

Le serveur fournit un accès aux ressources Google Tasks :

• Ressource Tâche (gtasks:///<task_id>)
  • Représente une tâche individuelle dans Google Tasks
  • Prend en charge la lecture des informations détaillées de la tâche, y compris le titre, le statut, la date d'échéance, les notes et d'autres métadonnées
  • Peut être utilisée avec les outils fournis pour lister, lire, créer, mettre à jour et supprimer des tâches

Installation et Configuration

Prérequis

1. Créer un projet Google Cloud

   • Accéder à Google Cloud Console pour créer un nouveau projet

2. Activer l'API Google Tasks

   • Activer l'API dans Google Cloud Console

3. Configurer l'écran de consentement OAuth

   • Configurer dans l'écran de consentement OAuth
   • Sélectionner "internal" pour l'environnement de test
   • Ajouter le scope : https://www.googleapis.com/auth/tasks

4. Créer un ID client OAuth

   • Créer dans la page des identifiants
   • Sélectionner "Application de bureau" comme type d'application
   • Télécharger le fichier JSON de la clé OAuth
   • Renommer le fichier de clé en gcp-oauth.keys.json et le placer dans le répertoire racine du projet

Construire le Projet

Utiliser la commande suivante pour construire le serveur :

npm run build

Ou utiliser le mode d'écoute :

npm run watch

Installation Automatique (Recommandée)

Installer automatiquement via Smithery :

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

Authentification

1. Exécuter le serveur et s'authentifier :

npm run start auth

2. Cela ouvrira le processus d'authentification dans le navigateur système
3. Compléter le processus d'authentification
4. Les informations d'identification seront enregistrées dans le répertoire racine du projet (.gdrive-server-credentials.json)

Intégration avec Claude Desktop

Pour intégrer ce serveur avec l'application Claude Desktop, ajouter ce qui suit dans la configuration du serveur de l'application :

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

Caractéristiques Techniques

• Opérations CRUD complètes : Prend en charge la création, la lecture, la mise à jour et la suppression de tâches
• Fonctionnalité de recherche avancée : Permet de rechercher des tâches par mots-clés
• Gestion de l'état des tâches : Permet de marquer les tâches comme terminées ou en attente
• Prise en charge de la pagination : Fournit une fonctionnalité de pagination lors du traitement d'un grand nombre de tâches
• Authentification OAuth 2.0 : Accès sécurisé à l'API Google
• Prise en charge de TypeScript : Offre une sécurité de type et une meilleure expérience de développement

Cas d'Utilisation

• Gestion des tâches personnelles : Gérer les tâches quotidiennes via l'interaction en langage naturel avec Claude
• Collaboration de projet : Gérer l'attribution des tâches dans les projets d'équipe via un assistant IA
• Flux de travail automatisé : Combiner avec d'autres outils pour automatiser la gestion des tâches
• Amélioration de la productivité : Créer et mettre à jour rapidement des tâches par la voix ou le texte

Précautions

• Nécessite un compte Google valide et un accès à Google Tasks
• L'authentification OAuth doit être effectuée lors de la première utilisation
• Il est recommandé de conserver en toute sécurité le fichier d'informations d'identification d'authentification dans un environnement de production
• Respecter les quotas et les limites d'utilisation de l'API Google