Busca e descoberta de conexões no Apple Notes

apple-notes é um servidor MCP para busca semântica e descoberta de conexões nas próprias Notas da Apple do usuário — busca híbrida, pontes Swanson-ABC, threads de entidades e síntese citada sobre tudo o que ele escreveu. Embeddings, busca, BM25, clustering e pontes rodam no dispositivo; apenas a geração de síntese chama um LLM (local OU nuvem, a escolha do usuário).

Esta habilidade cobre (1) a configuração única que você deve guiar o usuário e (2) qual ferramenta usar, já que o servidor expõe muitas.

Quando Usar Esta Habilidade

• Use quando o usuário quiser encontrar, recordar ou pesquisar algo em suas próprias Notas da Apple ("busque nas minhas notas por X", "o que eu escrevi sobre X", "eu anotei Y alguma vez").
• Use quando o usuário quiser exibir conexões não óbvias entre suas notas ("encontre pontes/conexões entre minhas notas", "o que liga X e Y", "mostre notas relacionadas").
• Use quando o usuário quiser sintetizar uma posição a partir de suas notas ("resuma o que eu penso sobre X a partir das minhas notas", "reúna tudo o que escrevi sobre X").
• Use também para "indexar minhas Notas da Apple", consultas por tags/pastas e "o que está conectado a X".
• Não use para criar lembretes ou para sistemas de notas que não sejam do Apple Notes.

Primeiro: o MCP está conectado?

Se as ferramentas apple-notes não estiverem disponíveis, o servidor ainda não foi registrado — faça a Configuração abaixo antes de qualquer outra coisa. Se as ferramentas existirem, mas uma busca retornar "não indexado" ou vazia, execute index-notes primeiro (veja as ressalvas de Ranking).

Configuração (guie o usuário por isso — é o real valor da habilidade)

O servidor lê diretamente o armazenamento SQLite do Apple Notes, então o binário do bun precisa de Acesso Completo ao Disco. Passos, em ordem:

1. Instale o bun (se ausente): brew install oven-sh/bun/bun
2. Clone + instale as dependências:

   git clone https://github.com/connerkward/mcp-apple-notes
   cd mcp-apple-notes
   git checkout <reviewed-tag-or-commit>
   bun install
   

3. Conceda Acesso Completo ao Disco ao bun. Execute which bun, depois abra Ajustes do Sistema → Privacidade e Segurança → Acesso Completo ao Disco, clique em + e adicione esse binário bun exato (comumente /opt/homebrew/bin/bun ou /usr/local/bin/bun). Sem isso, o servidor não consegue ler o NoteStore.sqlite e toda chamada falha com um erro de permissão. (O pós-instalação do bun install tenta abrir este painel automaticamente.)
4. Registre o servidor MCP (escolha o cliente do usuário):
   • Claude Code: claude mcp add apple-notes -- bun /absolute/path/to/mcp-apple-notes/index.ts --stdio
   • Claude Desktop: adicione ao claude_desktop_config.json:

     { "mcpServers": { "apple-notes": {
         "command": "/Users/<you>/.bun/bin/bun",
         "args": ["/Users/<you>/mcp-apple-notes/index.ts", "--stdio"] } } }
     

   • Como um plugin do Claude Code (que também inclui esta habilidade): /plugin marketplace add connerkward/ckw-skills e depois /plugin install apple-notes@connerkward.
5. Reinicie o cliente, depois diga ao usuário para pedir "Indexar minhas Notas da Apple" (ou chame index-notes). A primeira indexação de ~1.800 notas leva alguns segundos.

Mapa de ferramentas — qual ferramenta para qual tarefa

…