FocusBox MCP — référence des outils

URL du connecteur : https://focusbox.io/mcp/api. Voir /mcp pour la configuration.

list_today

Retourne les tâches de l'utilisateur planifiées pour aujourd'hui (uniquement les non terminées).

Arguments

Aucun.

Retourne

Tableau de { taskId, name, durationSeconds, projectId }.

Exemple de réponse

[
  { "taskId": "abc", "name": "Write spec", "durationSeconds": 1500, "projectId": "mytasks" }
]

next_task

Retourne une seule tâche à commencer, choisie selon ce qui tient dans le temps disponible avant le prochain événement de l'agenda, ce qui a été reporté des jours précédents et ce qui est assez court pour être commencé. Inclut la raison, deux alternatives et un lien pour démarrer.

Arguments

availableMinutes (1-480, optionnel).

Retourne

{ task, alternatives, freeWindowMinutes, busyNow, message }.

Exemple de réponse

{
  "task": {
    "taskId": "abc", "name": "Finish pricing page", "projectId": "work",
    "estimateMinutes": 35, "source": "rollover",
    "reason": "Carried over from 2 days ago; fits the 47 min you have before your next meeting.",
    "startUrl": "https://focusbox.io/now?id=work&taskId=abc"
  },
  "alternatives": [],
  "freeWindowMinutes": 47, "busyNow": false,
  "message": "Start here: Finish pricing page (35 min)."
}

get_streams

Liste les projets FocusBox de l'utilisateur (conteneurs de tâches ; appelés « streams » dans l'API pour des raisons historiques). Les projets archivés et les buckets today/mytasks sont exclus.

Arguments

Aucun.

Retourne

Tableau de { streamId, name }.

add_task

Ajoute une nouvelle tâche à un projet ou la planifie pour aujourd'hui. La durée par défaut est de 25 minutes.

Arguments

Retourne

{ taskId, streamId, name, durationSeconds }.

update_task

Met à jour un ou plusieurs champs d'une tâche existante : name, durationSeconds ou dueDate.

Arguments

Retourne

{ taskId, streamId, name, durationSeconds, dueDate }.

delete_task

Supprime définitivement une tâche. Idempotent : supprimer une tâche déjà supprimée n'est pas une erreur.

Arguments

Retourne

{ taskId, streamId, deleted, reason? }.

complete_task

Marque une tâche FocusBox comme terminée.

Arguments

Retourne

{ taskId, streamId, completed: true }.

get_insights_30d

Résumé agrégé des tâches terminées par l'utilisateur sur les 30 derniers jours.

Arguments

Aucun.

Retourne

{ totalTasks, totalFocusMinutes, topStreams[{streamId, name, tasks}, days: 30 }].

Authentification

OAuth (recommandé pour Claude)

Claude Desktop et claude.ai sur le web complètent le flux OAuth automatiquement. Aucune gestion d'API key n'est nécessaire.

Bearer (Cursor, Inspector, clients personnalisés)

Récupérez votre API key sur /account/api-keys (commence par apikey_). Envoyez-la sous Authorization: Bearer apikey_xxx à chaque requête.

Limites de débit

300 appels d'outils par tranche de 2 minutes par API key. 60 sondes non authentifiées par tranche de 2 minutes par IP.

FAQ