Om Agenda te Outomatiseer

U kan kragtige werkvloeie skep deur Agenda te outomatiseer, wat op ’n hoë vlak gedoen kan word met byvoorbeeld Siri-kortpaaie of die Kortpaaie-toep, of op ’n lae vlak deur byvoorbeeld x-callback-url-ondersteuning. Die moontlikhede is eindeloos!

Toep-kortpaaie

Vanaf Agenda 15 is Toep-kortpaaie maniere om vinnig een of meer take in Agenda deur middel van die Kortpaaie-toep af te handel. Deur verskeie Agenda-kortpaaie te kombineer, opsioneel met dié van ander toeps, kan u u werkvloeie skep en outomatiseer. Van die eenvoudige oopmaak van ’n spesifieke nota vanaf die Tuisskerm van u iPad, of die aktivering van ’n nuwe nota ná ’n dubbeltik agterop u foon, tot komplekse werkvloeie wat al die dinge wat u vandag moet doen uit verskillende toeps gryp en met een tik ’n nuwe projek skep.

Agenda vir iOS ondersteun ook Siri-kortpaaie vir algemene aksies soos die oopmaak van ’n sekere nota, projek of oorsig.

Deursoek Notas in Kortpaaie

U kan die Deursoek Notas-aksie in die Kortpaaie-toep gebruik om notas te vind wat aan spesifieke kriteria voldoen. Dit is ook via x-callback-url beskikbaar. Soekbevrae ondersteun aksiesintaksis soos \color, \done, \pinned, en meer, wat u dieselfde krag as soektogte binne die toep vanuit u outomatiserings gee.

Siri

U kan Siri gebruik om u notas te deursoek en met Agenda te werk. Vra Siri byvoorbeeld net om iets in Agenda te soek, en u kan die resultate direk voorskou. Siri ondersteun ook ryker uitruil van data tussen Agenda en ander toeps.

Beheersentrum

Op iOS bied Agenda Beheersentrum-knoppies wat u toelaat om vinnig na die Vandag- of Op die Agenda-oorsigte te spring sonder om eers die toep oop te maak. U kan hierdie knoppies in u toestel se Beheersentrum-instellings byvoeg.

x-callback-url-ondersteuning

Agenda ondersteun ook x-callback-URL’e. Hierdie laat u toe om werkvloeie tussen toeps te koppel en/of sekere aksies binne Agenda te outomatiseer. Dit word ook deur Apple se Kortpaaie-toep ondersteun.

’n Vinnige inleiding tot x-callback-URL’e:

Die BA-skema is agenda of agenda-notes
Bevele sluit tans on-the-agenda, today, open-project, ens. in.
Vir “open-project” en “open-note” kan u die teiken met ’n title-parameter bepaal.
Soos gewoonlik kan u terugroep-URL’e verskaf via die opsionele x-success- en x-error-parameters.

Byvoorbeeld, om Agenda by ’n nota met die naam “Meeting With Peta” oop te maak, kan u hierdie BA gebruik: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Nuut in Agenda 23: die move-note-aksie laat u toe om ’n nota tussen projekte te skuif vanuit ’n ander toep of kortpad: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

MCP (Model Context Protocol)-integrasie

Agenda bevat ’n ingeboude MCP-bediener op macOS wat KI-assistente toelaat om met u notas, projekte en kategorieë te werk. MCP is ’n oop protokol wat gereedskap soos Claude Code, Claude Desktop, Cursor en Codex gebruik om met toeps te kommunikeer.

Om die MCP-bediener te aktiveer

Die MCP-bediener is by verstek af. Om dit te aktiveer, gaan na die Agenda-kieslys en kies Integrasies > Enable MCP. Die bediener loop plaaslik op u Mac by http://127.0.0.1:16106/mcp en is slegs vanaf u eie masjien toeganklik.

Die Integrasies-kieslys bied ook opsies om konfigurasiebevele te kopieer om verskeie KI-gereedskap te verbind, sowel as ’n Claude Desktop-inprop wat direk afgelaai en geïnstalleer kan word.

Beskikbare gereedskap

Die MCP-bediener bied die volgende gereedskap vir KI-assistente om te gebruik:

search_notes — Deursoek u notas volgens teks, etikette, datums en ander kriteria
get_note — Haal die volledige inhoud van ’n spesifieke nota op
list_projects — Lys alle projekte, opsioneel met inbegrip van gearchiveerdes
list_categories — Lys alle kategorieë
open_note — Maak ’n spesifieke nota in Agenda oop
create_note — Skep ’n nuwe nota in ’n projek, met opsionele lêeraanhegsels
append_to_note — Voeg inhoud en/of lêeraanhegsels by ’n bestaande nota
edit_note — Wysig die inhoud van ’n bestaande nota, met opsionele lêeraanhegsels
create_project — Skep ’n nuwe projek
create_category — Skep ’n nuwe kategorie
move_note — Skuif ’n bestaande nota na ’n ander projek (nuut in Agenda 23)

Om KI-gereedskap te verbind

Om ’n KI-gereedskap aan Agenda se MCP-bediener te verbind, gebruik die konfigurasiebevel uit die Integrasies-kieslys, of stel dit handmatig op:

Claude Code:

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

Claude Desktop / Cursor: Gebruik npx mcp-remote http://localhost:16106/mcp as die bevel in u MCP-konfigurasie. As alternatief kan u die Claude Desktop-inprop direk vanuit die Integrasies-kieslys installeer.

Codex: Voeg die volgende by ~/.codex/config.toml:

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

Aanhegsels

Die create_note-, append_to_note- en edit_note-gereedskap ondersteun die byvoeging van lêeraanhegsels by notas. Aanhegsels word as base64-geënkodeerde data gestuur, sodat ’n KI-assistent ’n lêer van u Mac kan lees, dit kan enkodeer, en dit in een stap aan ’n nota kan heg. U kan byvoorbeeld u KI-assistent vra om “hierdie PDF aan my Vergaderingsnotas te heg” en dit sal die res hanteer.

Elke aanhegsel vereis ’n filename (met uitbreiding, sodat Agenda die lêertipe ken) en die base64-geënkodeerde lêer-data. U kan opsioneel beheer hoe die aanhegsel gewys word met displayStyle (inline, thumbnail, thumbnail-with-details, of full-width) en displaySize (small, medium, of large).

Beperkings: tot 20 aanhegsels per versoek, met ’n totale maksimum van 100 MB aan lêerdata.

Hulpbronne vir hulp

Die MCP-bediener stel ook hulpbronne beskikbaar wat algemene onderwerpe uit die Agenda-dokumentasie dek, sodat KI-assistente kan naslaan hoe kenmerke werk en beter antwoorde oor Agenda kan gee.

Wat u kan vra

Sodra u KI-gereedskap verbind is, kan dit u notas op versoek lees en wysig. ’n Paar voorbeelde van wat goed werk:

“Vat my vergaderingsnotas van hierdie week saam in ’n nuwe nota in die Weekly Reviews-projek.”
“Vind enigiets wat met #followup geëtiketteer is en wat Anna noem, en lys dit.”
“Voeg die aksie-items uit hierdie PDF onderaan my Project Kickoff-nota by.” (die KI kan ook lêers heg)
“Skuif die ‘Q2 Planning’-nota van Drafts na die Strategy-projek.”
“Skep ’n nuwe projek genaamd Holiday en saai dit met ’n paklys.”

Omdat die MCP-bediener plaaslik op u Mac loop, verlaat u notas nooit u masjien op pad na die KI-gereedskap nie — slegs die spesifieke teks wat die assistent lees of skryf word daardeur gestuur.

Probleemoplossing

As u KI-gereedskap nie Agenda kan sien nie:

Is MCP geaktiveer? Gaan Agenda > Integrasies > Enable MCP na. Die kieslysitem verander na Disable MCP wanneer die bediener loop.
Loop Agenda? Die bediener leef binne die Agenda-toep — as Agenda afsluit, stop die bediener saam daarmee.
Het die KI-gereedskap herverbind nadat MCP geaktiveer is? Sommige kliënte kas die verbinding by aanvang. Herbegin die KI-gereedskap as dit reeds geloop het voordat u MCP geaktiveer het.
Word poort 16106 deur iets anders gebruik? ’n Vinnige toets vanuit Terminaal: curl http://127.0.0.1:16106/mcp behoort ’n antwoord te lewer (nie “connection refused” nie).

Let wel: Die MCP-bediener is slegs op macOS beskikbaar.