Agenda Le guide de l’utilisateur
Sur cette page
Télécharger en PDF

Automatiser Agenda

Vous pouvez créer des flux de travail puissants en automatisant Agenda, que ce soit à haut niveau avec les raccourcis Siri ou l’app Raccourcis, ou à bas niveau grâce à la prise en charge des x-callback-url, par exemple. Les possibilités sont infinies !

Raccourcis d’app

Depuis Agenda 15, les raccourcis d’app permettent d’accomplir rapidement une ou plusieurs tâches dans Agenda via l’app Raccourcis. En combinant plusieurs raccourcis Agenda, éventuellement avec ceux d’autres apps, vous pouvez créer et automatiser vos flux de travail. Cela va de la simple ouverture d’une note précise depuis l’écran d’accueil de votre iPad, ou de la création d’une note après un double tap à l’arrière de votre téléphone, jusqu’à des flux de travail complexes qui rassemblent depuis différentes apps tout ce que vous devez faire aujourd’hui et créent un nouveau projet en un seul tap.

Agenda pour iOS prend aussi en charge les raccourcis Siri pour des actions courantes comme l’ouverture d’une note, d’un projet ou d’une vue d’ensemble.

Rechercher des notes dans Raccourcis

Vous pouvez utiliser l’action Rechercher des notes dans l’app Raccourcis pour trouver les notes correspondant à des critères précis. Elle est également disponible via x-callback-url. Les requêtes de recherche prennent en charge la syntaxe d’actions comme \color, \done, \pinned et bien d’autres, ce qui vous donne dans vos automatisations la même puissance que la recherche dans l’app.

Siri

Vous pouvez utiliser Siri pour effectuer des recherches dans vos notes et interagir avec Agenda. Par exemple, demandez simplement à Siri de rechercher quelque chose dans Agenda, et vous pourrez prévisualiser les résultats directement. Siri prend également en charge des échanges de données plus riches entre Agenda et d’autres apps.

Centre de contrôle

Sur iOS, Agenda propose des boutons de Centre de contrôle qui vous permettent d’accéder rapidement aux vues d’ensemble Aujourd’hui ou Sur l’agenda sans ouvrir l’app au préalable. Vous pouvez ajouter ces boutons dans les réglages du Centre de contrôle de votre appareil.

Prise en charge des x-callback-url

Agenda prend aussi en charge les x-callback-url. Celles-ci permettent de relier des flux de travail entre apps et/ou d’automatiser certaines actions dans Agenda. Elles sont également prises en charge par l’app Raccourcis d’Apple.

Petite introduction aux x-callback-url :

  • Le schéma d’URL est agenda ou agenda-notes
  • Les commandes actuelles incluent on-the-agenda, today, open-project, etc.
  • Pour « open-project » et « open-note », vous pouvez préciser la cible à l’aide d’un paramètre title.
  • Comme d’habitude, vous pouvez fournir des URL de rappel via les paramètres facultatifs x-success et x-error.

Par exemple, pour ouvrir Agenda sur une note intitulée « Réunion avec Peta », vous pourriez utiliser cette URL : agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Nouveau dans Agenda 23 : l’action move-note vous permet de déplacer une note d’un projet à un autre depuis une autre app ou un raccourci : agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Intégration MCP (Model Context Protocol)

Agenda intègre un serveur MCP sur macOS qui permet aux assistants IA d’interagir avec vos notes, projets et catégories. MCP est un protocole ouvert utilisé par des outils comme Claude Code, Claude Desktop, Cursor et Codex pour communiquer avec les apps.

Activer le serveur MCP

Le serveur MCP est désactivé par défaut. Pour l’activer, allez dans le menu Agenda et choisissez Intégrations > Activer MCP. Le serveur s’exécute localement sur votre Mac à l’adresse http://127.0.0.1:16106/mcp et n’est accessible que depuis votre propre machine.

Le menu Intégrations propose également des options pour copier les commandes de configuration permettant de connecter divers outils d’IA, ainsi qu’un plug-in Claude Desktop qui peut être téléchargé et installé directement.

Outils disponibles

Le serveur MCP met à disposition des assistants IA les outils suivants :

Rechercher et lire

  • search_notes — Recherchez dans vos notes par texte, tags, dates et autres critères
  • get_note — Récupérez le contenu complet d’une note donnée
  • get_selection — Récupérez la note ou le projet sélectionné dans Agenda, pour pouvoir dire « cette note »
  • list_projects — Listez tous les projets, en incluant éventuellement ceux qui sont archivés
  • list_categories — Listez toutes les catégories
  • list_templates — Listez vos modèles de notes, pour créer une note à partir de l’un d’eux
  • list_overviews — Listez vos vues d’ensemble enregistrées
  • list_attachments — Listez les fichiers et dessins d’une note (nouveau dans Agenda 23.4)
  • get_attachment — Récupérez le fichier original d’une pièce jointe (nouveau dans Agenda 23.4)

Afficher dans Agenda

  • open_note — Ouvrez une note donnée dans Agenda
  • open — Mettez Agenda au premier plan et accédez à Aujourd’hui, Sur l’agenda, une recherche, un projet ou une vue d’ensemble enregistrée

Créer et modifier

  • create_note — Créez une nouvelle note dans un projet, avec des fichiers joints en option
  • append_to_note — Ajoutez du contenu et/ou des fichiers joints à une note existante
  • edit_note — Modifiez le contenu d’une note existante, avec des fichiers joints en option
  • move_note — Déplacez une note existante vers un autre projet
  • trash_note — Placez une note dans la corbeille
  • untrash_note — Restaurez une note depuis la corbeille
  • create_project — Créez un nouveau projet
  • update_project — Renommez un projet, déplacez-le vers une autre catégorie, modifiez son ordre de tri, archivez-le, ou placez-le dans la corbeille et récupérez-le
  • create_category — Créez une nouvelle catégorie
  • update_category — Renommez une catégorie, changez sa couleur, imbriquez-la dans une autre catégorie, ou ramenez-la au niveau supérieur

Exporter

  • export_pdf — Enregistrez des notes, ou un projet entier, dans un seul fichier PDF

Rien ne peut être supprimé définitivement via MCP. Une note ou un projet qu’un assistant place dans la corbeille y reste jusqu’à ce que vous vidiez la corbeille, et les catégories ne peuvent pas du tout être supprimées.

Connecter des outils d’IA

Pour connecter un outil d’IA au serveur MCP d’Agenda, utilisez la commande de configuration du menu Intégrations, ou configurez-le manuellement :

Claude Code :

claude mcp add --transport http agenda http://localhost:16106/mcp

Claude Desktop / Cursor : Utilisez npx mcp-remote http://localhost:16106/mcp comme commande dans votre configuration MCP. Vous pouvez également installer le plug-in Claude Desktop directement depuis le menu Intégrations.

Codex : Ajoutez ce qui suit à ~/.codex/config.toml :

[mcp_servers.agenda]
url = "http://127.0.0.1:16106/mcp"

Éléments liés

Les outils create_note, append_to_note et edit_note permettent d’ajouter des fichiers joints aux notes. Les fichiers joints sont envoyés sous forme de données encodées en base64, si bien qu’un assistant IA peut lire un fichier sur votre Mac, l’encoder et le joindre à une note en une seule étape. Vous pourriez par exemple demander à votre assistant IA de « joindre ce PDF à ma note Compte rendu de réunion », et il se chargera du reste.

Chaque fichier joint nécessite un filename (avec son extension, pour qu’Agenda connaisse le type de fichier) et les données du fichier encodées en base64 (data). Vous pouvez éventuellement contrôler la manière dont l’élément lié est affiché à l’aide de displayStyle (inline, thumbnail, thumbnail-with-details ou full-width) et de displaySize (small, medium ou large).

Limites : jusqu’à 20 fichiers joints par requête, pour un maximum total de 100 Mo de données.

Récupérer des fichiers d’une note (nouveau dans Agenda 23.4)

Un assistant peut aussi récupérer un fichier depuis une note, par exemple pour lire un PDF que vous avez joint ou pour l’envoyer ailleurs. L’outil list_attachments liste les fichiers et dessins d’une note. L’outil get_attachment crée ensuite une copie en lecture seule du fichier original, avec le nom que vous voyez dans Agenda, et indique son emplacement à l’assistant. Cette copie est temporaire : Agenda la supprime à son prochain lancement.

Si votre outil d’IA ne peut pas lire les fichiers du dossier d’Agenda, il peut à la place demander directement le contenu du fichier (jusqu’à 100 Mo, fichiers uniquement). Un dossier ou un paquet est fourni sous forme de dossier, et un dessin sous forme de son image d’aperçu. Les fichiers joints des notes verrouillées ne sont pas disponibles.

Ressources d’aide

Le serveur MCP expose également des ressources d’aide couvrant les sujets courants de la documentation d’Agenda, afin que les assistants IA puissent consulter le fonctionnement des fonctionnalités et fournir de meilleures réponses au sujet d’Agenda.

Ce que vous pouvez demander

Une fois votre outil d’IA connecté, il peut lire et modifier vos notes à la demande. Voici quelques exemples qui fonctionnent bien :

  • « Résume mes comptes rendus de réunion de cette semaine dans une nouvelle note du projet Bilans hebdomadaires. »
  • « Trouve tout ce qui porte le tag #followup et mentionne Anna, et fais-en la liste. »
  • « Ajoute les actions à mener de ce PDF au bas de ma note Lancement du projet. » (l’IA peut aussi joindre des fichiers)
  • « Déplace la note “Planification T2” de Brouillons vers le projet Stratégie. »
  • « Crée un nouveau projet appelé Vacances et remplis-le avec une liste de bagages. »
  • « Prends le PDF de la facture dans ma note “Facturation de mars” et dis-moi le total. »

Comme le serveur MCP s’exécute localement sur votre Mac, vos notes ne quittent jamais votre machine en chemin vers l’outil d’IA — seul le texte précis que l’assistant lit ou écrit y transite.

Dépannage

Si votre outil d’IA ne voit pas Agenda :

  • MCP est-il activé ? Vérifiez Agenda > Intégrations > Activer MCP. L’élément de menu bascule sur Désactiver MCP lorsque le serveur fonctionne.
  • Agenda est-il lancé ? Le serveur vit à l’intérieur de l’app Agenda — si Agenda quitte, le serveur s’arrête avec elle.
  • L’outil d’IA s’est-il reconnecté après l’activation de MCP ? Certains clients mettent la connexion en cache au lancement. Redémarrez l’outil d’IA s’il était déjà ouvert avant que vous n’activiez MCP.
  • Le port 16106 est-il utilisé par autre chose ? Un test rapide depuis le Terminal : curl http://127.0.0.1:16106/mcp doit renvoyer une réponse (et non « connection refused »).

Remarque : le serveur MCP n’est disponible que sur macOS.