local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables semantic search and retrieval of Apple Notes content, allowing access to notes during AI assistant conversations. Supports both full-text and semantic search capabilities using on-device embeddings.

Notas de Apple MCP

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

Características

🔍 Búsqueda semántica en Apple Notes utilizando el modelo de incrustaciones en el dispositivo all-MiniLM-L6-v2
📝 Capacidades de búsqueda de texto completo
Almacenamiento vectorial mediante LanceDB
Servidor compatible con MCP para la integración del asistente de IA
Integración nativa de Apple Notes mediante JXA
🏃‍♂️ Ejecución totalmente local: no se necesitan claves API

Prerrequisitos

Instalación

Clonar el repositorio:

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

Instalar dependencias:

bun install

Uso

Abra la aplicación de escritorio de Claude y vaya a Configuración -> Desarrollador -> Editar configuración

Abra claude_desktop_config.json y agregue 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: Reemplace <YOUR_USER_NAME> con su nombre de usuario real.

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

Empieza por indexar tus notas. Pídele a Claude que indexe tus notas diciendo algo como: "Indexar mis notas" o "Indexar 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

Todos

[ ] Las notas de Apple se devuelven en formato HTML. Deberíamos convertirlas a Markdown e integrarlas.
[ ] Divida el contenido de origen mediante un divisor de texto recursivo o un divisor de texto de rebajas
[ ] Agregar una opción para usar un modelo de incrustaciones personalizado
[ ] Más control sobre la base de datos: purga, consultas personalizadas, etc.
[x] Almacenamiento de notas en Notas a través de Claude

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

Permite la búsqueda semántica y RAG (Recuperación de Generación Aumentada) en tus Apple Notes.