Servidor MCP de Notas de Apple

Lee y escribe Notas de Apple, con soporte para formato nativo de Notas de Apple.

La mayoría de los servidores MCP de Notas de Apple solo pueden escribir texto plano. Este crea notas con formato nativo: los títulos, encabezados, negritas y listas se renderizan como estilos reales de Notas de Apple, no como texto plano. Esto se logra aprovechando la capacidad de importación de Markdown integrada en la aplicación Notas.

Requiere: macOS 26 (Tahoe) o posterior, Node.js 24+

Configuración

1. Añadir a tu cliente MCP

Claude Desktop — edita ~/Library/Application Support/Claude/claude_desktop_config.json:

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

Claude Code — ejecuta en la Terminal:

claude mcp add apple-notes -- npx -y @ailenshen/apple-notes-mcp@latest

2. Conceder permisos

Para admitir el formato nativo, el servidor utiliza la importación de Markdown integrada en la aplicación Notas: abre archivos .md con la aplicación Notas y confirma automáticamente el cuadro de diálogo de importación. Esto requiere dos permisos de macOS para node:

En el primer uso, macOS te pedirá que apruebes; simplemente haz clic en Permitir. Si te perdiste el aviso, ve a los ajustes anteriores y activa node manualmente. Después de conceder los permisos, reinicia tu cliente MCP.

Si falta un permiso, el servidor te dirá exactamente cuál es y cómo solucionarlo.

3. Empieza a usarlo

Simplemente habla con tu IA de forma natural:

• "Lista todas mis notas en la carpeta Proyectos"

• "Busca en mis notas 'agenda de reuniones'"

• "Lee mi nota Lista de la compra"

• "Crea una nota en Trabajo con los elementos de acción de hoy"

• "Actualiza mi Lista de la compra con estos nuevos elementos"

• "Elimina la nota llamada 'Borrador antiguo'"

¿Qué puede hacer?

Soporte de Markdown en Notas

Acceso remoto (modo HTTP)

¿Quieres acceder a tus Notas de Apple desde tu teléfono u otro ordenador?

npx @ailenshen/apple-notes-mcp@latest --http

Esto imprime una URL de punto final con un secreto integrado:

Endpoint: http://localhost:3100/mcp/a3f8b2c9e1d4...

Dirige tu cliente MCP remoto a esta URL. Para acceder a través de Internet, colócalo detrás de HTTPS usando un túnel (ngrok, Cloudflare Tunnel, etc.).

Para mantenerlo en ejecución tras reinicios, consulta la wiki para ver un ejemplo de LaunchAgent.

Cómo funciona

• Leer consulta la base de datos de Notas directamente a través de SQLite: rápido y seguro. El contenido se convierte de HTML de Apple a Markdown mediante turndown.

• Crear utiliza la importación nativa de Markdown de macOS (open -a Notes), por lo que el formato se conserva de forma nativa. La aplicación Notas aparece brevemente (~0.5s) durante la creación.

• Actualizar elimina la nota antigua y crea una nueva, conservando automáticamente la carpeta original.

• Eliminar mueve las notas a Eliminado recientemente, igual que al hacerlo manualmente.

Limitaciones conocidas

• Edición parcial de notas (p. ej., "corrige solo este párrafo") no es compatible. update_note siempre reemplaza el contenido completo. Esta es una limitación fundamental de cómo Notas expone el contenido: su interfaz de AppleScript devuelve HTML, no el Markdown original, por lo que un ciclo completo de lectura→edición→escritura limpio no es posible hoy en día.

• Notas aparece brevemente durante la creación de notas. El flujo de importación de Markdown requiere confirmar automáticamente un cuadro de diálogo en la aplicación Notas, lo que puede traerla momentáneamente al primer plano.

Estas limitaciones se eliminarían si Apple añade la importación/exportación de Markdown a AppleScript, o abre una API oficial de Notas; ambas están bajo seguimiento para futuras versiones de macOS.

Visión

Notas de Apple es el lugar más natural para guardar el conocimiento personal en dispositivos Apple: se sincroniza en todas partes, es rápido y es privado. Pero es un jardín vallado sin API.

Este proyecto convierte a Notas de Apple en una fuente de datos de primera clase para la IA. El objetivo a largo plazo: dondequiera que estés hablando con la IA (en tu Mac, en tu teléfono, en la web), tus Notas de Apple siempre sean accesibles, legibles y editables.

Licencia

MIT