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 :

  • 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
  • list_projects — Listez tous les projets, en incluant éventuellement ceux qui sont archivés
  • list_categories — Listez toutes les catégories
  • open_note — Ouvrez une note donnée dans Agenda
  • 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
  • create_project — Créez un nouveau projet
  • create_category — Créez une nouvelle catégorie
  • move_note — Déplacez une note existante vers un autre projet (nouveau dans Agenda 23)

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.

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. »

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.