Accès MCP (agents IA)

Ce qui a changé récemment

MCP est désormais entièrement disponible sur iPhone (en plus de l'application web). L'écran iPhone reflète celui du web et inclut les mêmes extraits de configuration pour tous les clients IA pris en charge.

Forfait Pro et au-dessus

L'accès MCP nécessite un forfait Pro ou Ultra. Les deux forfaits ont l'accès complet read + write (20 outils). Ultra a des quotas plus élevés et peut aussi basculer en mode read-only.

MCP (Model Context Protocol) te permet de connecter des assistants IA de code et des outils d'automatisation directement à tes données TellDone. Une fois connecté, ton agent IA peut lire tes notes, tâches, événements et rapports - et créer, mettre à jour et supprimer des éléments. Il y a 20 outils au total : 9 pour lire les données et 11 pour écrire.

Disponible à la fois dans l'application iPhone (Paramètres → Intégrations → Agents IA) et dans l'application web (Paramètres → Agents IA).

Prérequis par forfait

Forfait	MCP
Free	Verrouillé
Basic	Verrouillé
Pro	Read + Write (20 outils)
Ultra	Read + Write (20 outils, quotas plus élevés) - peut aussi basculer en mode Read-only

L'écran in-app

L'écran Agents IA a trois états selon ton forfait et l'état d'activation de MCP.

Verrouillé (Free et Basic)

Si tu es sur le forfait Free ou Basic, l'écran explique ce que fait MCP et affiche un bouton Passer à un forfait supérieur. Appuie dessus pour ouvrir l'écran de mise à niveau et passer à Pro ou Ultra.

Désactivé (Pro et Ultra, fonctionnalité éteinte)

Si tu es sur Pro ou Ultra mais que tu n'as pas encore activé MCP, l'écran montre un court résumé de ce que ton forfait peut faire (nombre d'outils, mode d'accès, quotas) et un bouton Activer. Appuie dessus pour générer ton token de connexion et démarrer l'intégration.

Activé

Une fois activé, l'écran affiche tout ce qu'il te faut pour connecter un client IA :

Bascule de mode - sur Ultra tu peux basculer entre Read-only et Read + Write. Sur Pro le mode est fixé sur Read + Write.
Ligne Token d'accès avec un œil pour révéler ou masquer le token et un bouton de copie.
Sélecteur Configuration avec onglets pour Claude Code, Cursor, Windsurf et Autre. L'extrait de code correspondant apparaît sous les onglets - il suffit de copier-coller dans ton client IA.
Bouton Régénérer - tourne le token immédiatement et déconnecte toutes les sessions actives utilisant l'ancien.
Bouton Désactiver - éteint MCP et supprime le token. Tu peux réactiver plus tard, mais un nouveau token sera émis.

astuce

Garde ton token de connexion privé. Quiconque possède le token peut accéder à tes données TellDone. Utilise Régénérer si tu soupçonnes une fuite du token.

Comment activer

Tu peux configurer MCP depuis l'une ou l'autre plateforme :

iPhone : Paramètres → Intégrations → Agents IA (MCP)
Web : app.telldone.app → Paramètres → Agents IA

Étapes :

Appuie sur Activer.
Choisis ton mode d'accès (Ultra uniquement - Pro est toujours Read + Write).
Révèle et copie ton token avec les icônes œil et copie.
Choisis ton outil dans la section Configuration (Claude Code, Cursor, Windsurf ou Autre).
Colle l'extrait dans la config de ton client IA.

Connecter ton outil IA

Les quatre onglets du sélecteur Configuration in-app (Claude Code, Cursor, Windsurf, Autre) correspondent aux sections ci-dessous. Remplace YOUR_TOKEN par le token de tes paramètres dans tous les exemples.

Claude Code

Lance cette commande dans ton terminal :

claude mcp add telldone --transport http \
  https://api.telldone.app/mcp/user/mcp \
  --header "Authorization: Bearer YOUR_TOKEN"

Cursor

Ajoute à .cursor/mcp.json :

{
  "mcpServers": {
    "telldone": {
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Windsurf

Ajoute à .codeium/windsurf/mcp_config.json :

{
  "mcpServers": {
    "telldone": {
      "serverUrl": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

Autre

Utilise ces extraits pour les clients que le sélecteur in-app regroupe sous Autre.

Codex

Ajoute à codex.json :

{
  "mcpServers": {
    "telldone": {
      "type": "http",
      "url": "https://api.telldone.app/mcp/user/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

OpenClaw

Settings > MCP Servers > Add :

Name : TellDone
URL : https://api.telldone.app/mcp/user/mcp
Auth : Bearer YOUR_TOKEN

Autres clients MCP

Tout outil qui prend en charge MCP via HTTP peut se connecter. Utilise l'endpoint https://api.telldone.app/mcp/user/mcp avec un en-tête d'autorisation Bearer YOUR_TOKEN.

En-tête d'auth alternatif

Si ton client ou proxy réserve l'en-tête Authorization (par exemple, certaines passerelles façon Smithery), envoie le token dans X-MCP-Token: YOUR_TOKEN à la place. Les deux en-têtes fonctionnent ; si les deux sont présents, Authorization gagne.

Tester ta connexion

Tu peux vérifier que ton token fonctionne avec une commande cURL simple :

curl -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

Une réponse réussie liste tous les outils disponibles.

Ce que tu peux faire

Outils de lecture (9) - Pro et Ultra

Outil	Ce qu'il fait
get_notes	Liste les notes avec filtres (tags, plage de dates, recherche texte)
get_note	Voir une seule note avec ses tâches enfants, événements et transcription complète
get_notes_full	Récupérer plusieurs notes avec tâches et événements intégrés en un seul appel
get_tasks	Liste les tâches filtrées par statut (à faire, terminé, tout), tags ou dates
get_events	Liste les événements de calendrier, filtre par plage de dates
get_reports	Lit tes rapports quotidiens, hebdomadaires, mensuels et annuels (markdown complet)
get_tags	Voir tous tes tags triés par usage
get_profile	Voir tes infos de compte et statistiques d'usage
search	Recherche dans notes, tâches et événements (texte + recherche sémantique pour les notes)

astuce

L'outil search prend en charge la recherche sémantique pour les notes - il trouve des résultats par sens, pas seulement par mots-clés. Par exemple, chercher « réunions sur le budget » trouvera des notes sur des discussions financières même si elles ne contiennent pas le mot « budget ».

Outils d'écriture (11) - Pro et Ultra

Outil	Ce qu'il fait
process_note	Pipeline IA complet - envoie texte ou audio, récupère une note avec tâches, événements et tags
create_note	Ajoute une note texte simple (pas d'analyse IA)
create_task	Ajoute une tâche avec priorité, échéance, rappel et tags
create_event	Ajoute un événement de calendrier avec date, heure, lieu, rappels, participants et récurrence
update_note	Change le titre, résumé, type, tags, priorité ou statut de note
update_task	Change le titre, description, priorité, échéance, rappel, tags ou statut de tâche
complete_task	Marque une tâche comme faite
update_event	Change les détails, l'heure, le lieu, les rappels, les participants, la récurrence, les tags ou le statut d'événement
delete_note	Supprime une note et toutes ses tâches et événements liés
delete_task	Supprime une tâche
delete_event	Supprime un événement

Toutes les opérations d'écriture et de suppression apparaissent instantanément sur tes appareils connectés (téléphone, application web) via la synchro en temps réel.

Référence des outils

get_notes

Liste les notes avec filtrage facultatif. Les filtres de date utilisent recorded_at (quand tu as enregistré la note vocale), pas created_at.

Paramètre	Type	Défaut	Description
`limit`	int	20	Nombre de notes à renvoyer (max 50)
`offset`	int	0	Sauter ce nombre de notes (pour la pagination, max 10000)
`tags`	string	-	Filtrer par tags, séparés par virgules (correspond à n'importe lequel)
`search`	string	-	Recherche texte sur titre et résumé
`date_from`	string	-	Date de début, YYYY-MM-DD (incluse)
`date_to`	string	-	Date de fin, YYYY-MM-DD (exclue)

Renvoie : liste de notes avec id, title, summary, type, tags, priority, status, recorded_at, created_at.

get_note

Récupère une seule note avec sa transcription complète et toutes ses tâches et événements liés.

Paramètre	Type	Description
`note_id`	string	L'UUID de la note

Renvoie : note avec title, summary, transcript, type, tags, priority, status, metadata, created_at, plus les tableaux tasks[] et events[].

get_notes_full

Récupère plusieurs notes avec leurs tâches et événements en un seul appel. Mêmes filtres que get_notes, mais chaque note inclut tasks[] et events[] intégrés.

Paramètre	Type	Défaut	Description
`limit`	int	10	Nombre de notes (max 20)
`offset`	int	0	Sauter ce nombre de notes
`tags`	string	-	Filtrer par tags
`date_from`	string	-	Date de début, YYYY-MM-DD
`date_to`	string	-	Date de fin, YYYY-MM-DD

get_tasks

Liste les tâches avec filtrage.

Paramètre	Type	Défaut	Description
`status`	string	"todo"	Filtre : `todo`, `done` ou `all`
`limit`	int	30	Nombre de tâches (max 100)
`offset`	int	0	Sauter ce nombre de tâches
`tags`	string	-	Filtrer par tags, séparés par virgules
`date_from`	string	-	Date de début, YYYY-MM-DD (filtre par échéance ; les tâches sans échéance sont exclues)
`date_to`	string	-	Date de fin, YYYY-MM-DD (filtre par échéance ; les tâches sans échéance sont exclues)

Renvoie : liste de tâches avec id, title, description, status, priority, tags, deadline, reminder_at, completed_at, completed_by, source, created_at.

get_events

Liste les événements de calendrier avec filtrage par plage de dates.

Paramètre	Type	Défaut	Description
`limit`	int	30	Nombre d'événements (max 100)
`offset`	int	0	Sauter ce nombre d'événements
`date_from`	string	-	Date de début, YYYY-MM-DD (filtre par heure de début d'événement)
`date_to`	string	-	Date de fin, YYYY-MM-DD

Renvoie : liste d'événements avec id, title, description, status, start_at, end_at, location, is_all_day, tags, created_at.

remarque

get_events ne renvoie pas attendees, reminder_minutes ni recurrence_rule. Ces champs sont modifiables via create_event/update_event mais pas inclus dans la sortie de liste. Si tu en as besoin, récupère la note parente avec get_note.

get_reports

Récupère tes rapports générés par IA avec contenu markdown complet.

Paramètre	Type	Défaut	Description
`report_type`	string	"daily"	Type : `daily`, `weekly`, `monthly` ou `yearly`
`limit`	int	5	Nombre de rapports (max 10)

Renvoie : liste de rapports avec id, type, period_start, period_end, content_md, created_at.

remarque

Les rapports mensuels peuvent faire 3 000 à 5 000 mots. Utilise limit=1 si ton outil IA a une fenêtre de contexte serrée.

get_tags

Récupère tous tes tags, triés par épinglés en premier, puis par nombre d'utilisations.

Pas de paramètres. Renvoie jusqu'à 100 tags, chacun avec tag, usage_count, is_pinned, is_manual.

get_profile

Récupère tes infos de compte et statistiques d'usage.

Pas de paramètres. Renvoie email, display_name, locale, transcription_locale, timezone, subscription, mcp_mode, created_at et stats (compteurs notes/tâches/événements).

search

Recherche dans notes, tâches et événements en même temps. Pour les notes, prend en charge la recherche texte et la recherche sémantique (trouve des résultats par sens grâce aux embeddings IA).

Paramètre	Type	Défaut	Description
`query`	string	requis	Texte de recherche (max 500 caractères)
`limit`	int	20	Résultats max par type (max 20)
`semantic`	bool	true	Active la recherche sémantique pour les notes

Renvoie les résultats groupés par type : notes[], tasks[], events[]. Chaque résultat a id, type, title, detail, created_at.

Mets semantic=false pour une recherche texte plus rapide.

process_note (Pro et Ultra)

Pipeline IA complet - fonctionne comme un enregistrement dans l'application. Envoie texte ou audio, et TellDone va transcrire, analyser avec l'IA et créer une note structurée avec tâches, événements, tags et embeddings extraits.

Cet outil est asynchrone : il renvoie immédiatement un audio_id et traite en arrière-plan. Les résultats arrivent via la synchro en temps réel sur tes appareils connectés, ou tu peux interroger avec get_notes().

Paramètre	Type	Description
`text`	string	Texte à analyser (saute la transcription si pas d'audio fourni)
`audio_base64`	string	Fichier audio encodé en base64 (jusqu'à 50 Mo, déclenche la transcription)
`audio_format`	string	`m4a`, `ogg`, `wav`, `mp3`, `aac` ou `webm` (défaut : m4a)
`parent_task_id`	string	UUID d'une tâche dont c'est un suivi
`parent_note_id`	string	UUID d'une note dont c'est un suivi
`parent_event_id`	string	UUID d'un événement dont c'est un suivi

Tu dois fournir soit text, soit audio_base64 (ou les deux - l'audio est prioritaire pour la transcription).

Renvoie : {"audio_id": "...", "status": "processing", "mode": "text-only"} ou "mode": "audio+stt" si un audio a été fourni.

remarque

process_note est soumis aux quotas de ton forfait (envois par jour, notes par mois, longueur max de texte). Utilise get_profile pour vérifier ton usage actuel.

create_note (Pro et Ultra)

Crée instantanément une note texte simple. Ne déclenche pas l'analyse IA - aucune tâche ni événement n'est extrait. Pour l'analyse IA complète avec extraction de tâches/événements, utilise plutôt process_note.

Paramètre	Type	Limite	Description
`title`	string	200 car.	Requis
`summary`	string	1000 car.	Facultatif. Court teaser (1 à 3 phrases). Inclus dans les prompts de rapport, à garder concis
`transcript`	string	selon forfait	Facultatif. Corps long affiché dans le détail. Pas inclus dans les rapports. Limites : Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000 caractères
`type`	string	-	Facultatif. `task`, `idea`, `info` (défaut), `status`, `meeting`, `event` ou `reflection`
`tags`	string	20 tags	Séparés par virgules, facultatif

create_task (Pro et Ultra)

Crée une nouvelle tâche.

Paramètre	Type	Limite	Description
`title`	string	200 car.	Requis
`description`	string	2000 car.	Facultatif
`priority`	string	-	`low`, `medium` (défaut) ou `high`
`deadline`	string	-	YYYY-MM-DD, facultatif
`reminder_at`	string	-	Datetime ISO 8601 (par exemple `2026-04-15T09:00:00Z`), facultatif
`tags`	string	20 tags	Séparés par virgules, facultatif
`note_id`	string	-	UUID pour lier la tâche à une note parente, facultatif

create_event (Pro et Ultra)

Crée un événement de calendrier.

Paramètre	Type	Limite	Description
`title`	string	200 car.	Requis
`start_at`	string	-	Datetime ISO 8601, requis
`end_at`	string	-	Datetime ISO 8601 (défaut : début + 1 heure)
`description`	string	2000 car.	Facultatif
`location`	string	200 car.	Facultatif
`is_all_day`	bool	-	Défaut : false
`tags`	string	20 tags	Séparés par virgules, facultatif
`reminder_minutes`	string	-	Minutes avant l'événement séparées par virgules (par exemple `15,60`), facultatif
`attendees`	string	-	Noms ou e-mails séparés par virgules, facultatif
`recurrence_rule`	string	-	Chaîne RRULE (par exemple `FREQ=WEEKLY;BYDAY=MO,WE,FR`), facultatif
`note_id`	string	-	UUID pour lier l'événement à une note parente, facultatif

update_note (Pro et Ultra)

Met à jour un ou plusieurs champs d'une note existante. Seuls les champs fournis sont modifiés.

Paramètre	Type	Description
`note_id`	string	Requis, l'UUID de la note
`title`	string	Nouveau titre (max 200 car.)
`summary`	string	Nouveau résumé (max 1000 car., passe un espace `" "` pour effacer)
`transcript`	string	Nouvelle transcription (limite selon forfait, passe un espace `" "` pour effacer)
`type`	string	`task`, `idea`, `info`, `status`, `meeting`, `event` ou `reflection`
`tags`	string	Tags séparés par virgules (remplace tous les tags existants, max 20)
`priority`	string	`low`, `medium` ou `high`
`status`	string	`active` ou `archived`

attention

Pour les notes créées par le pipeline vocal, transcript est la sortie originale de la reconnaissance vocale. La remplacer remplace la source canonique - envisage plutôt de l'append si tu veux préserver l'original.

update_task (Pro et Ultra)

Met à jour un ou plusieurs champs d'une tâche existante. Seuls les champs fournis sont modifiés.

Paramètre	Type	Description
`task_id`	string	Requis, l'UUID de la tâche
`title`	string	Nouveau titre
`description`	string	Nouvelle description (passe un espace `" "` pour effacer)
`priority`	string	`low`, `medium` ou `high`
`deadline`	string	YYYY-MM-DD (passe un espace pour effacer)
`status`	string	`todo` ou `done`
`tags`	string	Tags séparés par virgules (remplace tous les tags existants, max 20)
`reminder_at`	string	Datetime ISO 8601 (passe un espace pour effacer)

Mettre status à done enregistre aussi quand et comment la tâche a été terminée.

complete_task (Pro et Ultra)

Raccourci pour marquer une tâche comme faite.

Paramètre	Type	Description
`task_id`	string	Requis, l'UUID de la tâche

Renvoie une erreur si la tâche n'existe pas ou est déjà terminée.

update_event (Pro et Ultra)

Met à jour un ou plusieurs champs d'un événement existant. Seuls les champs fournis sont modifiés.

Paramètre	Type	Description
`event_id`	string	Requis, l'UUID de l'événement
`title`	string	Nouveau titre
`description`	string	Nouvelle description (passe un espace pour effacer)
`start_at`	string	Nouvelle heure de début (ISO 8601)
`end_at`	string	Nouvelle heure de fin (ISO 8601)
`location`	string	Nouveau lieu (passe un espace pour effacer)
`status`	string	`confirmed`, `tentative` ou `cancelled`
`tags`	string	Tags séparés par virgules (remplace tous les tags existants, max 20)
`is_all_day`	string	`"true"` ou `"false"`
`reminder_minutes`	string	Minutes avant l'événement séparées par virgules (par exemple `15,60`)
`attendees`	string	Noms ou e-mails séparés par virgules
`recurrence_rule`	string	Chaîne RRULE (passe un espace pour effacer)

delete_note (Pro et Ultra)

Supprime une note. Cela supprime aussi toutes les tâches et événements créés à partir de cette note.

Paramètre	Type	Description
`note_id`	string	Requis, l'UUID de la note

delete_task (Pro et Ultra)

Supprime une tâche.

Paramètre	Type	Description
`task_id`	string	Requis, l'UUID de la tâche

delete_event (Pro et Ultra)

Supprime un événement.

Paramètre	Type	Description
`event_id`	string	Requis, l'UUID de l'événement

Limites d'entrée

Champ	Longueur max	Utilisé dans
title	200 caractères	create/update note, task, event
description	2 000 caractères	create/update task, event
summary	1 000 caractères (strict)	create/update note. Inclus dans les prompts de rapport, court pour contrôler le coût en tokens
transcript	selon forfait : Free 2 000 / Basic 8 000 / Pro 20 000 / Ultra 50 000	create/update note. Corps long, pas dans les rapports
location	200 caractères	create/update event
tags	20 tags	create/update note, task, event
search query	500 caractères	search
audio_base64 (décodé)	50 Mo	process_note

Si tu dépasses une limite, l'outil renvoie un message d'erreur du genre "title too long (max 200 chars, got 250)".

Gestion des erreurs

Tous les outils renvoient du JSON. Les erreurs utilisent ce format :

{"error": "description of what went wrong"}

Erreurs courantes :

Erreur	Quand
`"MCP access is read-only..."`	Outil d'écriture appelé en mode read-only
`"Invalid note_id format"`	Chaîne non-UUID passée comme ID
`"Note not found"`	L'ID n'existe pas ou appartient à un autre utilisateur
`"Task not found or already completed"`	`complete_task` sur tâche inexistante ou déjà faite
`"title too long (max 200 chars, got N)"`	Limite d'entrée dépassée
`"Too many tags (max 20)"`	Plus de 20 tags fournis

Erreurs au niveau HTTP :

Code	Sens
401	Bearer token invalide ou manquant
403	MCP désactivé ou forfait n'autorisant pas MCP
429	Limite de débit dépassée (5 req/s)

Exemples d'usage

Tous les exemples utilisent cURL avec le protocole MCP JSON-RPC. Remplace YOUR_TOKEN par ton token de connexion.

Lecture de données

# Récupérer ton profil et tes stats
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"get_profile"}}'

# Lister les notes récentes (limite 5, à partir d'avril 2026)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call",
       "params":{"name":"get_notes","arguments":{"limit":5,"date_from":"2026-04-01"}}}'

# Rechercher des notes (texte hybride + sémantique)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call",
       "params":{"name":"search","arguments":{"query":"project deadline","limit":5}}}'

Écriture de données (Pro et Ultra)

# Traiter une note via le pipeline IA complet (extrait tâches + événements)
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":10,"method":"tools/call",
       "params":{"name":"process_note","arguments":{"text":"Need to buy groceries tomorrow. Meeting with Katie at 3pm at the cafe to discuss the project."}}}'

# Créer une tâche avec échéance et rappel
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":11,"method":"tools/call",
       "params":{"name":"create_task","arguments":{"title":"Review PR","priority":"high","deadline":"2026-04-15","reminder_at":"2026-04-15T09:00:00Z","tags":"dev"}}}'

# Créer un événement récurrent avec rappels et participants
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":12,"method":"tools/call",
       "params":{"name":"create_event","arguments":{"title":"Team standup","start_at":"2026-04-12T10:00:00Z","reminder_minutes":"15","attendees":"Katie,John","recurrence_rule":"FREQ=DAILY;BYDAY=MO,TU,WE,TH,FR","tags":"meeting"}}}'

# Terminer une tâche
curl -s -X POST https://api.telldone.app/mcp/user/mcp \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"jsonrpc":"2.0","id":13,"method":"tools/call",
       "params":{"name":"complete_task","arguments":{"task_id":"<task-uuid>"}}}'

Une réponse réussie ressemble à :

{
  "jsonrpc": "2.0",
  "id": 10,
  "result": {
    "content": [{"type": "text", "text": "{\"id\":\"...\",\"title\":\"Review PR\",\"status\":\"todo\"}"}]
  }
}

remarque

Les outils d'écriture et de mise à jour renvoient des réponses minimales avec uniquement id, title et status. Pour récupérer tous les détails (tags, priorité, échéance, etc.) après une écriture, fais un appel de lecture de suivi comme get_tasks ou get_note.

Gestion du token

Action	Comment
Voir le token	iPhone Paramètres → Intégrations → Agents IA (ou web Paramètres → Agents IA), appuie sur l'icône œil
Copier le token	Appuie sur l'icône de copie à côté du token
Régénérer	Appuie sur Régénérer et confirme. L'ancien token cesse de fonctionner immédiatement et toute session active est déconnectée
Changer de mode	Ultra uniquement - bascule entre Read-only et Read + Write. Sur Pro le mode est fixé sur Read + Write
Désactiver	Appuie sur Désactiver et confirme. Le token est supprimé et toutes les connexions s'arrêtent. Tu peux réactiver plus tard (un nouveau token sera émis)

Ce que tu peux demander à ton agent IA

Une fois connecté, demande à ton outil IA des choses comme :

Faire le bilan de ta journée :

« Sur quoi j'ai travaillé aujourd'hui ? »
« Affiche-moi mes notes de cette semaine »
« Quelles tâches sont en retard ? »

Gérer des tâches :

« Crée une tâche : revoir le rapport trimestriel, haute priorité, échéance vendredi »
« Marque la tâche Figma comme faite »
« Sur quelles tâches je travaille ? »

Rechercher et analyser :

« Trouve toutes les notes sur la stratégie marketing »
« Quels événements j'ai la semaine prochaine ? »
« Résume mes rapports quotidiens de la semaine dernière »

Planifier :

« Crée un événement : team standup demain à 10h »
« Qu'est-ce que j'ai dans mon calendrier cette semaine ? »
« Affiche mes top tags - sur quoi je passe le plus de temps ? »

L'agent IA a un accès complet à tes notes, tâches, événements et rapports. Il peut lire, créer, mettre à jour et supprimer des données, et répondre à des questions complexes en combinant des informations de plusieurs outils.

Notes importantes

Deux façons de créer des notes - create_note crée instantanément une note texte simple (pas d'analyse IA). process_note lance le pipeline IA complet (comme un enregistrement dans l'application) - il analyse le texte, extrait tâches et événements, génère tags et embeddings. Utilise process_note quand tu veux que TellDone réfléchisse pour toi.
Pas de synchro d'intégration - les éléments créés ou mis à jour via MCP ne déclenchent pas les automatisations webhook ni les synchros d'intégration (Todoist, Notion). Ils apparaîtront dans tes apps à la prochaine synchro.
La recherche sémantique dépend de l'outil - les notes créées avec process_note reçoivent des embeddings et apparaissent dans la recherche sémantique. Les notes créées avec create_note ne reçoivent pas d'embeddings, donc elles n'apparaissent que dans la recherche texte.
Les réponses d'écriture sont minimales - les outils de création et mise à jour renvoient seulement id, title et status. Pour tous les champs après une écriture, fais un appel de lecture de suivi.
Les filtres de date utilisent UTC - les paramètres date_from/date_to sont comparés comme timestamps UTC. Pour les utilisateurs hors UTC, les dates limites peuvent inclure ou exclure des éléments des jours adjacents.
Limite de débit - 5 requêtes par seconde. Pour les opérations en masse, espace tes requêtes.

Sécurité

Chaque utilisateur reçoit un token de connexion unique de 384 bits
Ton token est révoqué instantanément quand tu désactives MCP ou le régénères
Toutes les données sont strictement isolées à ton compte - ton agent ne peut accéder qu'à tes propres données
Chaque requête est cantonnée à ton utilisateur - aucun moyen pour un agent d'accéder aux données d'un autre utilisateur
La connexion utilise HTTPS avec limitation de débit (5 req/s)

Voir aussi

Automatisations webhook - envoie des données vers des services externes automatiquement
Todoist - synchro bidirectionnelle dédiée des tâches
Notion - intégration Notion dédiée

Prérequis par forfait​

L'écran in-app​

Verrouillé (Free et Basic)​

Désactivé (Pro et Ultra, fonctionnalité éteinte)​

Activé​

Comment activer​

Connecter ton outil IA​

Claude Code​

Cursor​

Windsurf​

Autre​

Codex​

OpenClaw​

Autres clients MCP​

Tester ta connexion​

Ce que tu peux faire​

Outils de lecture (9) - Pro et Ultra​

Outils d'écriture (11) - Pro et Ultra​

Référence des outils​

get_notes​

get_note​

get_notes_full​

get_tasks​

get_events​

get_reports​

get_tags​

get_profile​

search​

process_note (Pro et Ultra)​

create_note (Pro et Ultra)​

create_task (Pro et Ultra)​

create_event (Pro et Ultra)​

update_note (Pro et Ultra)​

update_task (Pro et Ultra)​

complete_task (Pro et Ultra)​

update_event (Pro et Ultra)​

delete_note (Pro et Ultra)​

delete_task (Pro et Ultra)​

delete_event (Pro et Ultra)​

Limites d'entrée​

Gestion des erreurs​

Exemples d'usage​

Lecture de données​

Écriture de données (Pro et Ultra)​

Gestion du token​

Ce que tu peux demander à ton agent IA​

Notes importantes​

Sécurité​

Voir aussi​

Prérequis par forfait

L'écran in-app

Verrouillé (Free et Basic)

Désactivé (Pro et Ultra, fonctionnalité éteinte)

Activé

Comment activer

Connecter ton outil IA

Claude Code

Cursor

Windsurf

Autre

Codex

OpenClaw

Autres clients MCP

Tester ta connexion

Ce que tu peux faire

Outils de lecture (9) - Pro et Ultra

Outils d'écriture (11) - Pro et Ultra

Référence des outils

get_notes

get_note

get_notes_full

get_tasks

get_events

get_reports

get_tags

get_profile

search

process_note (Pro et Ultra)

create_note (Pro et Ultra)

create_task (Pro et Ultra)

create_event (Pro et Ultra)

update_note (Pro et Ultra)

update_task (Pro et Ultra)

complete_task (Pro et Ultra)

update_event (Pro et Ultra)

delete_note (Pro et Ultra)

delete_task (Pro et Ultra)

delete_event (Pro et Ultra)

Limites d'entrée

Gestion des erreurs

Exemples d'usage

Lecture de données

Écriture de données (Pro et Ultra)

Gestion du token

Ce que tu peux demander à ton agent IA

Notes importantes

Sécurité

Voir aussi