Automatizar a Agenda

Podes criar fluxos de trabalho poderosos automatizando a Agenda, o que pode ser feito tanto a alto nível, por exemplo através dos atalhos da Siri ou da app Atalhos, como a baixo nível, por exemplo através do suporte para x-callback-url. As possibilidades são infinitas!

Atalhos da app

A partir da Agenda 15, os Atalhos da app são formas de concluir rapidamente uma ou mais tarefas na Agenda através da app Atalhos. Ao combinar vários Atalhos da Agenda, opcionalmente com os de outras apps, podes criar e automatizar os teus fluxos de trabalho. Desde a simples abertura de uma nota específica a partir do ecrã principal do teu iPad, passando por iniciar uma nova nota com um duplo toque nas costas do telemóvel, até fluxos de trabalho complexos que recolhem de várias apps tudo o que tens para fazer hoje e criam um novo projeto com um só toque.

A Agenda para iOS também suporta atalhos da Siri para ações comuns, como abrir uma determinada nota, projeto ou visão geral.

Pesquisar notas nos Atalhos

Podes usar a ação Pesquisar notas na app Atalhos para encontrar notas que correspondam a critérios específicos. Isto também está disponível através de x-callback-url. As consultas de pesquisa suportam a sintaxe de ações como \color, \done, \pinned e mais, dando-te o mesmo poder que a pesquisa dentro da app, a partir das tuas automatizações.

Siri

Podes usar a Siri para pesquisar nas tuas notas e interagir com a Agenda. Por exemplo, basta pedires à Siri para pesquisar algo na Agenda, e podes pré-visualizar os resultados diretamente. A Siri também suporta uma troca de dados mais rica entre a Agenda e outras apps.

Centro de Controlo

No iOS, a Agenda disponibiliza botões do Centro de Controlo que te permitem saltar rapidamente para as visões gerais Hoje ou Na Agenda sem abrires primeiro a app. Podes adicionar estes botões nas definições do Centro de Controlo do teu dispositivo.

Suporte para x-callback-url

A Agenda também suporta x-callback urls. Estes permitem-te ligar fluxos de trabalho entre apps e/ou automatizar certas ações dentro da Agenda. Também é suportado pela app Atalhos da Apple.

Uma breve introdução aos x-callback-urls:

O esquema de URL é agenda ou agenda-notes
Os comandos incluem atualmente on-the-agenda, today, open-project, etc.
Para “open-project” e “open-note”, podes indicar o destino usando um parâmetro title.
Como habitualmente, podes fornecer URLs de retorno através dos parâmetros opcionais x-success e x-error.

Por exemplo, para abrires a Agenda numa nota chamada “Meeting With Peta”, podias usar este URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

Novo na Agenda 23: a ação move-note permite-te mover uma nota entre projetos a partir de outra app ou atalho: agenda://x-callback-url/move-note?title=Meeting%20With%20Peta&project-title=Archive

Integração de MCP (Model Context Protocol)

A Agenda inclui um servidor MCP integrado no macOS que permite a assistentes de IA interagir com as tuas notas, projetos e categorias. O MCP é um protocolo aberto que ferramentas como o Claude Code, o Claude Desktop, o Cursor e o Codex usam para comunicar com apps.

Ativar o servidor MCP

O servidor MCP está desligado por predefinição. Para o ativares, vai ao menu Agenda e escolhe Integrações > Ativar MCP. O servidor funciona localmente no teu Mac em http://127.0.0.1:16106/mcp e só está acessível a partir da tua própria máquina.

O menu Integrações também disponibiliza opções para copiar comandos de configuração para ligar várias ferramentas de IA, bem como um plugin do Claude Desktop que pode ser transferido e instalado diretamente.

Ferramentas disponíveis

O servidor MCP disponibiliza as seguintes ferramentas para os assistentes de IA usarem:

search_notes — Pesquisa nas tuas notas por texto, etiquetas, datas e outros critérios
get_note — Obtém o conteúdo completo de uma nota específica
list_projects — Lista todos os projetos, incluindo opcionalmente os arquivados
list_categories — Lista todas as categorias
open_note — Abre uma nota específica na Agenda
create_note — Cria uma nova nota num projeto, com anexos de ficheiros opcionais
append_to_note — Adiciona conteúdo e/ou anexos de ficheiros a uma nota existente
edit_note — Modifica o conteúdo de uma nota existente, com anexos de ficheiros opcionais
create_project — Cria um novo projeto
create_category — Cria uma nova categoria
move_note — Move uma nota existente para um projeto diferente (novo na Agenda 23)

Ligar ferramentas de IA

Para ligares uma ferramenta de IA ao servidor MCP da Agenda, usa o comando de configuração do menu Integrações, ou configura-o manualmente:

Claude Code:

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

Claude Desktop / Cursor: Usa npx mcp-remote http://localhost:16106/mcp como comando na tua configuração de MCP. Em alternativa, instala o plugin do Claude Desktop diretamente a partir do menu Integrações.

Codex: Adiciona o seguinte a ~/.codex/config.toml:

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

Anexos

As ferramentas create_note, append_to_note e edit_note suportam a adição de anexos de ficheiros às notas. Os anexos são enviados como dados codificados em base64, pelo que um assistente de IA pode ler um ficheiro do teu Mac, codificá-lo e anexá-lo a uma nota num só passo. Por exemplo, podias pedir ao teu assistente de IA para “anexar este PDF às minhas Notas de Reunião” e ele trata do resto.

Cada anexo requer um filename (com extensão, para que a Agenda saiba o tipo de ficheiro) e os dados do ficheiro codificados em base64 em data. Podes opcionalmente controlar a forma como o anexo é apresentado usando displayStyle (inline, thumbnail, thumbnail-with-details ou full-width) e displaySize (small, medium ou large).

Limites: até 20 anexos por pedido, com um máximo total de 100 MB de dados de ficheiros.

Recursos de ajuda

O servidor MCP também expõe recursos de ajuda que cobrem tópicos comuns da documentação da Agenda, para que os assistentes de IA possam consultar como funcionam as funcionalidades e dar melhores respostas sobre a Agenda.

O que podes pedir

Depois de a tua ferramenta de IA estar ligada, ela pode ler e modificar as tuas notas a pedido. Alguns exemplos do que funciona bem:

“Resume as minhas notas de reunião desta semana numa nova nota no projeto Revisões Semanais.”
“Encontra tudo o que esteja etiquetado com #followup e que mencione a Anna, e faz uma lista.”
“Adiciona os itens de ação deste PDF ao fim da minha nota Arranque do Projeto.” (a IA também pode anexar ficheiros)
“Move a nota ‘Planeamento Q2’ de Rascunhos para o projeto Estratégia.”
“Cria um novo projeto chamado Férias e começa-o com uma lista de bagagem.”

Como o servidor MCP funciona localmente no teu Mac, as tuas notas nunca saem da tua máquina a caminho da ferramenta de IA — apenas o texto específico que o assistente lê ou escreve passa por ela.

Resolução de problemas

Se a tua ferramenta de IA não conseguir ver a Agenda:

O MCP está ativado? Verifica em Agenda > Integrações > Ativar MCP. O item de menu muda para Desativar MCP quando o servidor está em funcionamento.
A Agenda está a correr? O servidor vive dentro da app Agenda — se a Agenda sair, o servidor pára com ela.
A ferramenta de IA voltou a ligar-se depois de ativares o MCP? Alguns clientes guardam a ligação em cache no arranque. Reinicia a ferramenta de IA se ela já estava a correr antes de ativares o MCP.
A porta 16106 está a ser usada por outra coisa? Um teste rápido a partir do Terminal: curl http://127.0.0.1:16106/mcp deve devolver uma resposta (e não “connection refused”).

Nota: O servidor MCP só está disponível no macOS.