MCP Apple Notes

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 RAG over Apple Notes, allowing AI assistants to search and reference your Apple Notes during conversations

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

  1. Clonar el repositorio:
git clone https://github.com/RafalWilinski/mcp-apple-notes cd mcp-apple-notes
  1. Instalar dependencias:
bun install

Uso

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

  1. 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.

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

  1. 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
-
security - not tested
F
license - not found
-
quality - not tested

Un servidor de protocolo de contexto de modelo que permite la búsqueda semántica y RAG en tus notas de Apple, lo que permite que los asistentes de IA como Claude busquen y hagan referencia a tus notas durante las conversaciones.

  1. Features
    1. Prerequisites
      1. Installation
        1. Usage
          1. Troubleshooting
            1. Todos
              ID: dzx7naekwr