Automatizando o Agenda

Você pode criar fluxos de trabalho poderosos automatizando o Agenda, o que é possível tanto em alto nível, usando atalhos da Siri ou o aplicativo Atalhos, por exemplo, quanto em baixo nível, por meio do suporte a x-callback-url, por exemplo. As possibilidades são infinitas!

Atalhos do App

A partir do Agenda 15, os Atalhos do App são maneiras de realizar rapidamente uma ou mais tarefas no Agenda por meio do aplicativo Atalhos. Combinando vários Atalhos do Agenda, opcionalmente com os de outros aplicativos, você pode criar e automatizar seus fluxos de trabalho. Vai desde a simples abertura de uma nota específica a partir da Tela de Início do seu iPad, ou acionar uma nova nota após um toque duplo na traseira do telefone, até fluxos de trabalho complexos que reúnem tudo o que você precisa fazer hoje em diferentes aplicativos e criam um novo projeto com um toque.

O Agenda para iOS também é compatível com atalhos da Siri para ações comuns, como abrir determinada nota, projeto ou visão geral.

Buscar Notas nos Atalhos

Você pode usar a ação Buscar Notas no aplicativo Atalhos para encontrar notas que correspondam a critérios específicos. Isso também está disponível via x-callback-url. As consultas de busca aceitam sintaxe de ações como \color, \done, \pinned e outras, dando a você o mesmo poder da busca dentro do aplicativo a partir de suas automações.

Siri

Você pode usar a Siri para buscar em suas notas e interagir com o Agenda. Por exemplo, basta pedir à Siri para buscar algo no Agenda, e você pode pré-visualizar os resultados diretamente. A Siri também permite uma troca mais rica de dados entre o Agenda e outros aplicativos.

Central de Controle

No iOS, o Agenda oferece botões da Central de Controle que permitem ir rapidamente às visões gerais Hoje ou Na Agenda sem abrir o aplicativo antes. Você pode adicionar esses botões nos ajustes da Central de Controle do seu dispositivo.

Suporte a x-callback-url

O Agenda também é compatível com x-callback urls. Elas permitem acoplar fluxos de trabalho entre aplicativos e/ou automatizar certas ações dentro do Agenda. Também são suportadas pelo aplicativo Atalhos da Apple.

Uma introdução rápida às x-callback-urls:

O esquema de URL é agenda ou agenda-notes
Os comandos atualmente incluem on-the-agenda, today, open-project etc.
Para “open-project” e “open-note”, você pode estipular o alvo usando um parâmetro title.
Como de costume, você pode fornecer URLs de retorno pelos parâmetros opcionais x-success e x-error.

Por exemplo, para abrir o Agenda em uma nota chamada “Reunião Com a Peta”, você poderia usar este URL: agenda://x-callback-url/open-note?title=Meeting%20With%20Peta

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

Integração com MCP (Model Context Protocol)

O Agenda inclui um servidor MCP integrado no macOS que permite que assistentes de IA interajam com suas notas, projetos e categorias. O MCP é um protocolo aberto que ferramentas como Claude Code, Claude Desktop, Cursor e Codex usam para se comunicar com aplicativos.

Ativando o Servidor MCP

O servidor MCP vem desativado por padrão. Para ativá-lo, vá ao menu Agenda e escolha Integrações > Ativar MCP. O servidor roda localmente no seu Mac em http://127.0.0.1:16106/mcp e só é acessível a partir da sua própria máquina.

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

Ferramentas Disponíveis

O servidor MCP oferece as seguintes ferramentas para uso por assistentes de IA:

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

Conectando Ferramentas de IA

Para conectar uma ferramenta de IA ao servidor MCP do Agenda, use o comando de configuração do menu Integrações, ou configure manualmente:

Claude Code:

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

Claude Desktop / Cursor: Use npx mcp-remote http://localhost:16106/mcp como comando na sua configuração de MCP. Como alternativa, instale o plugin do Claude Desktop diretamente pelo menu Integrações.

Codex: Adicione 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 permitem adicionar anexos de arquivo às notas. Os anexos são enviados como dados codificados em base64, então um assistente de IA pode ler um arquivo do seu Mac, codificá-lo e anexá-lo a uma nota em uma única etapa. Por exemplo, você poderia pedir ao seu assistente de IA para “anexar este PDF às minhas Notas de Reunião”, e ele cuidará do resto.

Cada anexo requer um filename (com extensão, para que o Agenda saiba o tipo de arquivo) e os dados do arquivo codificados em base64, em data. Opcionalmente, você pode controlar como o anexo é exibido usando displayStyle (inline, thumbnail, thumbnail-with-details ou full-width) e displaySize (small, medium ou large).

Limites: até 20 anexos por solicitação, com um máximo total de 100 MB de dados de arquivo.

Recursos de Ajuda

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

O Que Você Pode Pedir

Depois que sua ferramenta de IA estiver conectada, ela pode ler e modificar suas notas mediante solicitação. Alguns exemplos do que funciona bem:

“Resuma minhas notas de reunião desta semana em uma nova nota no projeto Revisões Semanais.”
“Encontre qualquer coisa marcada com #followup que mencione a Anna e liste.”
“Adicione os itens de ação deste PDF ao final da minha nota Início do Projeto.” (a IA também pode anexar arquivos)
“Mova a nota ‘Planejamento do 2º Trimestre’ de Rascunhos para o projeto Estratégia.”
“Crie um novo projeto chamado Férias e comece com uma lista de bagagem.”

Como o servidor MCP roda localmente no seu Mac, suas notas nunca saem da sua máquina no caminho até a ferramenta de IA — apenas o texto específico que o assistente lê ou escreve passa por ele.

Resolução de Problemas

Se sua ferramenta de IA não consegue enxergar o Agenda:

O MCP está ativado? Verifique em Agenda > Integrações > Ativar MCP. O item de menu muda para Desativar MCP quando o servidor está em execução.
O Agenda está em execução? O servidor vive dentro do aplicativo Agenda — se o Agenda for encerrado, o servidor para junto.
A ferramenta de IA se reconectou depois que o MCP foi ativado? Alguns clientes armazenam a conexão em cache na inicialização. Reinicie a ferramenta de IA se ela já estava em execução antes de você ativar o MCP.
A porta 16106 está sendo usada por outra coisa? Um teste rápido no Terminal: curl http://127.0.0.1:16106/mcp deve retornar uma resposta (e não “connection refused”).

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