MCP Apple Notes

Un servidor del Protocolo de Contexto de Modelo (MCP) que permite la búsqueda semántica y RAG (Generación Aumentada por Recuperación) sobre tus notas de Apple. Funciona con cualquier cliente compatible con MCP: Claude Desktop, Cursor, Windsurf, Cline y otros.

Características

• 🔍 Búsqueda semántica en Apple Notes usando el modelo de embeddings en el dispositivo all-MiniLM-L6-v2

• 📝 Capacidades de búsqueda de texto completo

• 📂 Soporte para carpetas: listar carpetas, navegar por carpetas, filtrar búsquedas por carpeta

• 📊 Almacenamiento vectorial usando LanceDB

• 🤖 Funciona con cualquier cliente compatible con MCP (Claude, Cursor, Windsurf, Cline, etc.)

• 🍎 Integración nativa con Apple Notes mediante JXA

• 🔒 Modo de solo lectura opcional para una exploración segura

• 🏃♂️ Ejecución totalmente local: no se necesitan claves de API

Related MCP server: MCP Apple Notes

Seguridad y Transparencia

Debido a que este servidor interactúa con tus notas privadas de Apple, está diseñado teniendo en cuenta la transparencia absoluta. Se ejecuta al 100% localmente en tu Mac.

• Sin nube, sin telemetría — Sin claves de API, ningún dato sale de tu máquina.

• JXA nativo de Apple — Utiliza el puente de scripting oficial de Apple JavaScript for Automation.

• Embeddings en el dispositivo — El modelo all-MiniLM-L6-v2 se ejecuta localmente mediante @huggingface/transformers.

• Verificable — Se recomienda encarecidamente leer cada línea de código (especialmente index.ts) antes de que toque tus notas.

• Las versiones de GitHub incluyen sumas de verificación SHA-256 para que puedas verificar los artefactos descargados.

Instalación y Configuración

Elige el método de instalación que se adapte a tu flujo de trabajo.

Método 1: Instalar desde el código fuente (recomendado)

Al clonar el repositorio localmente, puedes inspeccionar el código fuente y saber exactamente qué se está ejecutando en tu máquina.

Requisitos previos: Node.js (v18+) o Bun

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && bun install

{
  "mcpServers": {
    "apple-notes": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

Usando NPM:

git clone https://github.com/Dan8Oren/mcp-apple-notes && cd mcp-apple-notes && npm install

Luego, añade el servidor a la configuración de tu cliente MCP. Reemplaza /path/to/mcp-apple-notes con la ruta donde clonaste el repositorio:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["tsx", "/path/to/mcp-apple-notes/index.ts"]
    }
  }
}

Consejo: ¿Quieres probarlo sin riesgos? Habilita el modo de solo lectura para bloquear todas las operaciones de escritura mientras exploras.
"env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }

Método 2: Inicio rápido mediante npx

Si prefieres un enfoque de configuración cero y confías en el paquete npm publicado, puedes simplemente añadir esto directamente a tu configuración de MCP:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

Después de la configuración, reinicia tu cliente y pídele a tu asistente de IA que "index my notes" (indexe mis notas) para comenzar.

Instrucciones por cliente

1. Abre Settings → Developer → Edit Config

2. Pega la configuración JSON elegida en claude_desktop_config.json

3. Reinicia Claude Desktop

Registros:

tail -n 50 -f ~/Library/Logs/Claude/mcp-server-apple-notes.log

# npm version:
claude mcp add apple-notes npx -- -y @dan8oren/mcp-apple-notes
# or from source:
claude mcp add apple-notes npx -- tsx /path/to/mcp-apple-notes/index.ts

Añade la configuración JSON a ~/.cursor/mcp.json (global) o .cursor/mcp.json en la raíz de tu proyecto.

Añade la configuración JSON a ~/.windsurf/mcp.json.

Herramientas disponibles

Verificación antes de confiar

Cada operación de Apple Notes es una llamada a JXA que puedes inspeccionar en index.ts. Sin solicitudes de red, sin sincronización en segundo plano, solo llamadas al puente de scripting local.

Modo de solo lectura

¿Quieres una red de seguridad? Habilita el modo de solo lectura para bloquear todas las operaciones de escritura; solo estarán disponibles las herramientas de búsqueda, listado y lectura:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_READ_ONLY": "1" }
    }
  }
}

Cuando está habilitado, solo están disponibles estas herramientas: index-notes, list-folders, list-notes, search-notes, get-note.

Modo detallado (verbose)

Habilita el registro detallado para ver cada llamada JXA antes de que se ejecute (registrado en stderr):

Flag de CLI — añade --verbose a los argumentos de configuración de tu cliente MCP:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["--verbose", "-y", "@dan8oren/mcp-apple-notes"]
    }
  }
}

Variable de entorno — para clientes que soportan env:

{
  "mcpServers": {
    "apple-notes": {
      "command": "npx",
      "args": ["-y", "@dan8oren/mcp-apple-notes"],
      "env": { "MCP_APPLE_NOTES_VERBOSE": "1" }
    }
  }
}

Referencia de operaciones JXA

Todas las operaciones pasan por el puente de scripting JXA de Apple (Application('Notes')). Sin acceso directo al sistema de archivos, sin llamadas de red. La operación delete no es permanente: las notas van a Eliminados recientemente y pueden recuperarse en un plazo de 30 días.

Formato de respuesta

Las respuestas de las herramientas son objetos JSON en un sobre consistente:

• Éxito: { "ok": true, "data": ... }

• Error: { "ok": false, "error": { "type": "...", "message": "..." } }

La mayoría de las respuestas orientadas a notas ahora incluyen el id estable de Apple Notes para que los clientes puedan rastrear las notas de forma segura a través de cambios de nombre y movimientos.

Agradecimientos

Originalmente basado en RafalWilinski/mcp-apple-notes.