Apple Notes

MCP Apple Notes

Un servidor de Protocolo de Contexto de Modelo (MCP) que permite búsqueda semántica y RAG (Generación Aumentada por Recuperación) sobre tus Notas de Apple. Esto permite que asistentes de IA como Claude busquen y referencien tus Notas de Apple durante las conversaciones.

Características

• 🔍 Búsqueda semántica sobre Notas de Apple usando el modelo de incrustaciones en el dispositivo all-MiniLM-L6-v2
• 📝 Capacidades de búsqueda de texto completo
• 📊 Almacenamiento vectorial usando LanceDB
• 🤖 Servidor compatible con MCP para integración con asistentes de IA
• 🍎 Integración nativa con Notas de Apple mediante JXA
• 🏃‍♂️ Ejecución completamente local: no se necesitan claves de API

Requisitos previos

• Bun
• Claude Desktop

Instalación

1. Clona el repositorio:

git clone https://github.com/RafalWilinski/mcp-apple-notes
cd mcp-apple-notes

2. Instala las dependencias:

bun install

Uso

1. Abre la aplicación de escritorio de Claude y ve a Configuración -> Desarrollador -> Editar configuración

2. Abre el claude_desktop_config.json y agrega la siguiente entrada:

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

Importante: Reemplaza <YOUR_USER_NAME> con tu nombre de usuario real.

3. Reinicia la aplicación de escritorio de Claude. Deberías ver esto:

4. Comienza indexando tus notas. Pídele a Claude que indexe tus notas diciendo algo como: "Indexa mis notas" o "Indexa mis Notas de Apple".

Solución de problemas

Para ver los registros:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-local-machine.log
# or
tail -n 50 -f ~/Library/Logs/Claude/mcp.log

Tareas pendientes

• Las notas de Apple se devuelven en formato HTML. Deberíamos convertirlas a Markdown e incrustarlas
• Dividir el contenido fuente usando un divisor de texto recursivo o un divisor de texto Markdown
• Agregar una opción para usar un modelo de incrustaciones personalizado
• Más control sobre la base de datos: purga, consultas personalizadas, etc.
• Almacenar notas en Notas mediante Claude