Agenda automatiseren

Je kunt krachtige workflows maken door Agenda te automatiseren, zowel op hoog niveau met bijvoorbeeld Siri-opdrachten of de app Opdrachten, als op laag niveau via bijvoorbeeld ondersteuning voor x-callback-url. De mogelijkheden zijn eindeloos!

App-opdrachten

Vanaf Agenda 15 zijn app-opdrachten een manier om via de app Opdrachten snel een of meer taken in Agenda uit te voeren. Door meerdere Agenda-opdrachten te combineren, eventueel met die van andere apps, kun je je workflows opzetten en automatiseren. Van het simpelweg openen van een bepaalde notitie vanaf het beginscherm van je iPad, of een nieuwe notitie starten na een dubbele tik op de achterkant van je telefoon, tot complexe workflows die alles wat je vandaag moet doen uit verschillende apps halen en er met één tik een nieuw project van maken.

Agenda voor iOS ondersteunt ook Siri-opdrachten voor veelvoorkomende acties zoals het openen van een bepaalde notitie, een bepaald project of een bepaald overzicht.

Notities zoeken in Opdrachten

Je kunt de actie Search Notes in de app Opdrachten gebruiken om notities te vinden die aan bepaalde criteria voldoen. Die is ook beschikbaar via x-callback-url. Zoekopdrachten ondersteunen actiesyntaxis als \color, \done, \pinned en meer, waarmee je vanuit je automatiseringen dezelfde kracht hebt als bij zoeken in de app zelf.

Siri

Je kunt Siri gebruiken om je notities te doorzoeken en met Agenda te werken. Vraag Siri bijvoorbeeld gewoon om iets in Agenda te zoeken, dan kun je de resultaten meteen bekijken. Siri ondersteunt ook een rijkere uitwisseling van gegevens tussen Agenda en andere apps.

Bedieningspaneel

Op iOS biedt Agenda knoppen voor het bedieningspaneel waarmee je snel naar de overzichten Vandaag of Op de agenda springt zonder eerst de app te openen. Je kunt die knoppen toevoegen in de instellingen van het bedieningspaneel van je apparaat.

Ondersteuning voor x-callback-url

Agenda ondersteunt ook x-callback-urls. Daarmee kun je workflows tussen apps koppelen en/of bepaalde acties binnen Agenda automatiseren. Ook de app Opdrachten van Apple ondersteunt dit.

Een korte introductie op x-callback-urls:

Het URL-schema is agenda of agenda-notes
Tot de commando’s behoren momenteel on-the-agenda, today, open-project enz.
Bij “open-project” en “open-note” geef je het doel op met een parameter title.
Zoals gebruikelijk kun je callback-URL’s meegeven via de optionele parameters x-success en x-error.

Om Agenda bijvoorbeeld te openen bij een notitie met de naam “Meeting With Peta”, gebruik je deze URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Nieuw in Agenda 23: met de actie move-note verplaats je vanuit een andere app of opdracht een notitie tussen projecten: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP-integratie (Model Context Protocol)

Agenda bevat op macOS een ingebouwde MCP-server waarmee AI-assistenten met je notities, projecten en categorieën kunnen werken. MCP is een open protocol dat programma’s als Claude Code, Claude Desktop, Cursor en Codex gebruiken om met apps te communiceren.

De MCP-server inschakelen

De MCP-server staat standaard uit. Om haar in te schakelen ga je naar het menu Agenda en kies je Integrations > Enable MCP. De server draait lokaal op je Mac op http://127.0.0.1:16106/mcp en is alleen vanaf je eigen machine bereikbaar.

Het menu Integrations biedt ook opties om configuratiecommando’s te kopiëren waarmee je verschillende AI-programma’s koppelt, en een Claude Desktop-plug-in die je rechtstreeks kunt downloaden en installeren.

Beschikbare tools

De MCP-server biedt de volgende tools voor AI-assistenten:

search_notes — Doorzoek je notities op tekst, tags, datums en andere criteria
get_note — Haal de volledige inhoud van een specifieke notitie op
list_projects — Toon alle projecten, eventueel inclusief gearchiveerde
list_categories — Toon alle categorieën
open_note — Open een specifieke notitie in Agenda
create_note — Maak een nieuwe notitie in een project, eventueel met bijlagen
append_to_note — Voeg inhoud en/of bijlagen toe aan een bestaande notitie
edit_note — Pas de inhoud van een bestaande notitie aan, eventueel met bijlagen
create_project — Maak een nieuw project
create_category — Maak een nieuwe categorie
move_note — Verplaats een bestaande notitie naar een ander project (nieuw in Agenda 23)

AI-programma’s koppelen

Om een AI-programma aan de MCP-server van Agenda te koppelen, gebruik je het configuratiecommando uit het menu Integrations, of stel je het handmatig in:

Claude Code:

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

Claude Desktop / Cursor: Gebruik npx mcp-remote http://localhost:16106/mcp als commando in je MCP-configuratie. Je kunt ook de Claude Desktop-plug-in rechtstreeks vanuit het menu Integrations installeren.

Codex: Voeg het volgende toe aan ~/.codex/config.toml:

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

Bijlagen

De tools create_note, append_to_note en edit_note ondersteunen het toevoegen van bijlagen aan notities. Bijlagen worden als base64-gecodeerde gegevens verstuurd, zodat een AI-assistent een bestand van je Mac kan lezen, coderen en in één stap aan een notitie kan toevoegen. Je kunt je AI-assistent bijvoorbeeld vragen “voeg deze PDF toe aan mijn Meeting Notes” en de rest wordt geregeld.

Elke bijlage vereist een filename (met extensie, zodat Agenda het bestandstype kent) en de base64-gecodeerde bestandsgegevens data. Optioneel bepaal je met displayStyle hoe de bijlage wordt weergegeven (inline, thumbnail, thumbnail-with-details of full-width) en met displaySize het formaat (small, medium of large).

Limieten: maximaal 20 bijlagen per verzoek, met in totaal maximaal 100 MB aan bestandsgegevens.

Hulpbronnen

De MCP-server biedt ook hulpbronnen over veelvoorkomende onderwerpen uit de documentatie van Agenda, zodat AI-assistenten kunnen opzoeken hoe functies werken en betere antwoorden over Agenda kunnen geven.

Wat je kunt vragen

Zodra je AI-programma is gekoppeld, kan het op verzoek je notities lezen en aanpassen. Een paar voorbeelden die goed werken:

“Vat mijn vergaderverslagen van deze week samen in een nieuwe notitie in het project Weekly Reviews.”
“Zoek alles met de tag #followup waarin Anna wordt genoemd en zet het op een rij.”
“Zet de actiepunten uit deze PDF onder aan mijn notitie Project Kickoff.” (de AI kan ook bestanden toevoegen)
“Verplaats de notitie ‘Q2 Planning’ van Drafts naar het project Strategy.”
“Maak een nieuw project met de naam Holiday en zet er alvast een paklijst in.”

Omdat de MCP-server lokaal op je Mac draait, verlaten je notities je machine niet op weg naar het AI-programma — alleen de specifieke tekst die de assistent leest of schrijft gaat erdoorheen.

Problemen oplossen

Ziet je AI-programma Agenda niet:

Staat MCP aan? Controleer Agenda > Integrations > Enable MCP. Het menuonderdeel verandert in Disable MCP zodra de server draait.
Draait Agenda? De server zit in de app Agenda — sluit Agenda af, dan stopt de server mee.
Heeft het AI-programma opnieuw verbinding gemaakt nadat je MCP inschakelde? Sommige clients bewaren de verbinding vanaf het opstarten in de cache. Herstart het AI-programma als het al draaide voordat je MCP inschakelde.
Wordt poort 16106 door iets anders gebruikt? Een snelle test vanuit Terminal: curl http://127.0.0.1:16106/mcp zou een reactie moeten geven (en niet “connection refused”).

Let op: De MCP-server is alleen beschikbaar op macOS.