Automatizzare Agenda

Puoi creare flussi di lavoro potenti automatizzando Agenda, cosa che si può fare sia ad alto livello, ad esempio con i comandi rapidi di Siri o con l’app Comandi rapidi, sia a basso livello, ad esempio tramite il supporto per gli x-callback-url. Le possibilità sono infinite!

Comandi rapidi dell’app

A partire da Agenda 15, i comandi rapidi dell’app sono un modo per svolgere rapidamente una o più attività in Agenda tramite l’app Comandi rapidi. Combinando più comandi rapidi di Agenda, eventualmente con quelli di altre app, puoi creare e automatizzare i tuoi flussi di lavoro. Dalla semplice apertura di una nota specifica dalla schermata Home del tuo iPad, all’avvio di una nuova nota dopo un doppio tocco sul retro del telefono, fino a flussi di lavoro complessi che raccolgono da app diverse tutte le cose che devi fare oggi e creano un nuovo progetto con un solo tocco.

Agenda per iOS supporta anche i comandi rapidi di Siri per azioni comuni come aprire una determinata nota, un progetto o una panoramica.

Cercare note in Comandi rapidi

Puoi usare l’azione Cerca note nell’app Comandi rapidi per trovare le note che corrispondono a criteri specifici. È disponibile anche tramite x-callback-url. Le query di ricerca supportano la sintassi delle azioni come \color, \done, \pinned e altre, offrendoti dalle tue automazioni la stessa potenza della ricerca all’interno dell’app.

Siri

Puoi usare Siri per cercare tra le tue note e interagire con Agenda. Ad esempio, basta chiedere a Siri di cercare qualcosa in Agenda e puoi visualizzare in anteprima i risultati direttamente. Siri supporta anche uno scambio di dati più ricco tra Agenda e altre app.

Centro di Controllo

Su iOS, Agenda mette a disposizione dei pulsanti per il Centro di Controllo che ti permettono di passare rapidamente alle panoramiche Oggi o In Agenda senza dover prima aprire l’app. Puoi aggiungere questi pulsanti nelle impostazioni del Centro di Controllo del tuo dispositivo.

Supporto per x-callback-url

Agenda supporta anche gli url x-callback. Consentono di collegare tra loro flussi di lavoro di app diverse e/o di automatizzare determinate azioni all’interno di Agenda. Sono supportati anche dall’app Comandi rapidi di Apple.

Una breve introduzione agli x-callback-url:

Lo schema URL è agenda o agenda-notes
Attualmente i comandi includono on-the-agenda, today, open-project, ecc.
Per “open-project” e “open-note” puoi indicare la destinazione usando un parametro title.
Come di consueto, puoi fornire URL di callback tramite i parametri facoltativi x-success e x-error.

Ad esempio, per aprire Agenda su una nota chiamata “Meeting With Peta”, potresti usare questo URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Novità in Agenda 23: l’azione move-note ti permette di spostare una nota da un progetto all’altro da un’altra app o da un comando rapido: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Integrazione MCP (Model Context Protocol)

Agenda include un server MCP integrato su macOS che consente agli assistenti IA di interagire con le tue note, i tuoi progetti e le tue categorie. MCP è un protocollo aperto che strumenti come Claude Code, Claude Desktop, Cursor e Codex usano per comunicare con le app.

Attivare il server MCP

Il server MCP è disattivato per impostazione predefinita. Per attivarlo, vai al menu Agenda e scegli Integrazioni > Attiva MCP. Il server viene eseguito localmente sul tuo Mac all’indirizzo http://127.0.0.1:16106/mcp ed è accessibile solo dalla tua macchina.

Il menu Integrazioni offre anche opzioni per copiare i comandi di configurazione necessari a collegare vari strumenti IA, oltre a un plugin per Claude Desktop che può essere scaricato e installato direttamente.

Strumenti disponibili

Il server MCP mette a disposizione degli assistenti IA i seguenti strumenti:

search_notes — Cerca tra le tue note per testo, tag, date e altri criteri
get_note — Recupera il contenuto completo di una nota specifica
list_projects — Elenca tutti i progetti, includendo facoltativamente quelli archiviati
list_categories — Elenca tutte le categorie
open_note — Apre una nota specifica in Agenda
create_note — Crea una nuova nota in un progetto, con allegati facoltativi
append_to_note — Aggiunge contenuti e/o allegati a una nota esistente
edit_note — Modifica il contenuto di una nota esistente, con allegati facoltativi
create_project — Crea un nuovo progetto
create_category — Crea una nuova categoria
move_note — Sposta una nota esistente in un progetto diverso (novità in Agenda 23)

Collegare gli strumenti IA

Per collegare uno strumento IA al server MCP di Agenda, usa il comando di configurazione dal menu Integrazioni, oppure configuralo manualmente:

Claude Code:

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

Claude Desktop / Cursor: Usa npx mcp-remote http://localhost:16106/mcp come comando nella tua configurazione MCP. In alternativa, installa il plugin per Claude Desktop direttamente dal menu Integrazioni.

Codex: Aggiungi quanto segue a ~/.codex/config.toml:

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

Allegati

Gli strumenti create_note, append_to_note ed edit_note supportano l’aggiunta di allegati alle note. Gli allegati vengono inviati come dati codificati in base64, così un assistente IA può leggere un file dal tuo Mac, codificarlo e allegarlo a una nota in un solo passaggio. Ad esempio, potresti chiedere al tuo assistente IA di “allegare questo PDF alle mie Note della riunione” e penserà lui a tutto il resto.

Ogni allegato richiede un filename (con estensione, così Agenda conosce il tipo di file) e i data del file codificati in base64. Puoi facoltativamente controllare come viene visualizzato l’allegato usando displayStyle (inline, thumbnail, thumbnail-with-details o full-width) e displaySize (small, medium o large).

Limiti: fino a 20 allegati per richiesta, con un massimo complessivo di 100 MB di dati.

Risorse di aiuto

Il server MCP espone anche risorse di aiuto che coprono gli argomenti più comuni della documentazione di Agenda, così gli assistenti IA possono consultare il funzionamento delle varie funzioni e fornire risposte migliori su Agenda.

Cosa puoi chiedere

Una volta collegato il tuo strumento IA, può leggere e modificare le tue note su richiesta. Ecco alcuni esempi di ciò che funziona bene:

“Riassumi le note delle mie riunioni di questa settimana in una nuova nota nel progetto Riepiloghi settimanali.”
“Trova tutto ciò che ha il tag #followup e menziona Anna, e mettilo in elenco.”
“Aggiungi le azioni da svolgere contenute in questo PDF in fondo alla mia nota Avvio del progetto.” (l’IA può anche allegare file)
“Sposta la nota ‘Pianificazione Q2’ da Bozze al progetto Strategia.”
“Crea un nuovo progetto chiamato Vacanza e inizializzalo con una lista delle cose da mettere in valigia.”

Poiché il server MCP viene eseguito localmente sul tuo Mac, le tue note non lasciano mai la tua macchina lungo il percorso verso lo strumento IA: attraverso di esso viene inviato soltanto il testo specifico che l’assistente legge o scrive.

Risoluzione dei problemi

Se il tuo strumento IA non riesce a vedere Agenda:

MCP è attivo? Controlla Agenda > Integrazioni > Attiva MCP. La voce di menu diventa Disattiva MCP quando il server è in funzione.
Agenda è in esecuzione? Il server vive all’interno dell’app Agenda: se Agenda viene chiusa, il server si arresta con essa.
Lo strumento IA si è ricollegato dopo l’attivazione di MCP? Alcuni client memorizzano la connessione all’avvio. Riavvia lo strumento IA se era già in esecuzione prima che tu attivassi MCP.
La porta 16106 è usata da qualcos’altro? Un test rapido dal Terminale: curl http://127.0.0.1:16106/mcp dovrebbe restituire una risposta (non “connection refused”).

Nota: il server MCP è disponibile solo su macOS.