Llevaba tiempo queriendo que Claude pudiera leer y escribir directamente en mi app de Notas de Apple, sin tener que copiar y pegar texto entre las dos ventanas. Esta semana lo resolví, y quiero dejar aquí el paso a paso por si a alguien más le sirve.

¿Qué es MCP y por qué importa?

MCP son las siglas de Model Context Protocol (Protocolo de Contexto de Modelo), un estándar abierto que Anthropic presentó en noviembre de 2024. Antes de MCP, si querías que un asistente de IA leyera tu correo, tu calendario o tus notas, alguien tenía que programar una integración a la medida para cada combinación de app y modelo. Con decenas de apps y varios modelos de IA en el mercado, eso se volvía un problema de “muchos contra muchos” imposible de mantener.

MCP resuelve esto con una idea simple: define un lenguaje común. Cualquier aplicación que “hable” MCP puede conectarse con cualquier asistente de IA que también lo entienda, sin código a la medida. Por eso se le compara con el USB-C: un solo tipo de conector que sirve para todo, en vez de un cable distinto por cada dispositivo. El estándar tuvo tanta acogida que hoy lo usan también OpenAI y Google DeepMind, y para diciembre de 2025 Anthropic reportaba más de 10.000 servidores MCP públicos activos.

Antes de seguir, un par de términos:

  • Servidor MCP: un programa pequeño que expone las funciones de una aplicación (crear una nota, buscar un archivo, enviar un mensaje) en el formato que MCP entiende. En este caso, el servidor “traduce” entre Claude y la app Notas.
  • Cliente MCP: la aplicación de IA que consume esas funciones. Claude Desktop es un cliente MCP.
  • AppleScript: un lenguaje de automatización propio de macOS que existe desde los años 90 y permite controlar aplicaciones como si un usuario estuviera haciendo clic por ti. El servidor que usé se apoya en AppleScript para hablar con Notas, porque Apple no ofrece una API en la nube para esta app: todo corre en local, en tu Mac.

Arquitectura de la solución

El flujo es simple:

Claude Desktop  (cliente MCP)
      │
      ▼
apple-notes-mcp  (servidor MCP, corre local vía Node/npx)
      │
      ▼
  AppleScript  (automatiza la app)
      │
      ▼
   Apple Notes

Claude le pide algo al servidor, el servidor lo traduce a AppleScript, y AppleScript hace clic por ti en la app Notas.

Lo que hicimos

Usé el servidor apple-notes-mcp (de sweetrb en GitHub), que hoy es de los mejor mantenidos para esta integración. Ofrece operaciones completas sobre Notas: crear, leer, buscar, mover y borrar notas y carpetas, listar cuentas, exportar la librería completa como respaldo, entre otras.

1. Verificar los requisitos

Todo corre sobre Node.js, así que primero confirmé la versión instalada:

node -v
npx -v

Cualquier versión de Node 20 en adelante funciona.

2. Ubicar el archivo de configuración de Claude Desktop

Claude Desktop guarda su configuración de servidores MCP en un archivo JSON:

cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

Si nunca has configurado un servidor MCP, es probable que ese archivo no tenga la clave mcpServers todavía, o incluso que no exista.

3. Agregar el servidor sin dañar la configuración existente

Como ese archivo puede tener más configuración (en mi caso, ajustes de Claude Cowork), en vez de editarlo a mano usé jq para modificarlo sin arriesgarme a un error de sintaxis:

# Respaldo por si algo sale mal
cp ~/Library/Application\ Support/Claude/claude_desktop_config.json \
   ~/Library/Application\ Support/Claude/claude_desktop_config.json.bak

# Agregar el servidor apple-notes
jq '.mcpServers["apple-notes"] = {"command": "npx", "args": ["-y", "apple-notes-mcp"]}' \
  ~/Library/Application\ Support/Claude/claude_desktop_config.json > /tmp/claude_config_new.json \
  && mv /tmp/claude_config_new.json ~/Library/Application\ Support/Claude/claude_desktop_config.json

npx -y apple-notes-mcp le dice a Node que descargue y ejecute el servidor directamente, sin necesidad de instalarlo de forma permanente.

4. Reiniciar Claude Desktop y dar permisos

Cerré Claude Desktop por completo (Cmd+Q) y lo volví a abrir. En cuanto Claude intentó usar el servidor por primera vez, macOS mostró el aviso estándar de Automatización pidiendo permiso para controlar la app Notas. Hay que aceptarlo.

Desde Settings → Developer en Claude Desktop se confirma que el servidor quedó “En ejecución”, y con el botón “Ver registros” se ve que todo corrió limpio: arranca, responde al handshake inicial y publica su catálogo de herramientas sin errores.

5. Probar la integración

Con todo conectado, le pedí a Claude que listara mis notas y que creara una nota de prueba. Ambas cosas funcionaron sin problema, directamente desde el chat.

apple-notes-mcp expone 36 herramientas en total. Algunas de las más útiles:

list-notes            search-notes           get-note-content
create-note           append-to-note         update-note
move-note             delete-note            batch-delete-notes
create-folder         list-folders           list-accounts
export-notes-json     get-notes-stats        doctor

6. Solución de problemas comunes

Si el servidor no arranca o Claude no ve las herramientas, lo más probable es que sea uno de estos casos:

  • Node.js no instalado o desactualizado: repite node -v; necesitas 20 o superior.
  • Claude Desktop desactualizado: el soporte de MCP mejora con cada versión; revisa que tengas la última.
  • Permiso de Automatización rechazado: si le dijiste “No” al aviso de macOS por error, ve a Ajustes del Sistema → Privacidad y Seguridad → Automatización y habilita el acceso de Claude a Notas manualmente.
  • Notas no sincronizadas con iCloud: si usas varias cuentas, confirma con qué cuenta está trabajando el servidor por defecto (herramienta get-default-location).
  • Error al descargar el paquete con npx: revisa tu conexión y que npm no esté bloqueado por un proxy o firewall corporativo.

Un apunte sobre privacidad

Es fácil pensar que, como el servidor corre en local, “nada sale de tu Mac”. Eso es cierto solo para la parte de automatización: AppleScript y apple-notes-mcp operan enteramente en tu equipo, sin API en la nube de Apple de por medio.

Pero el contenido de las notas que Claude consulta para responderte sí viaja al modelo, igual que pasa con cualquier texto que le pegarías en el chat. Si le pides “busca en mis notas todo sobre el proyecto X”, ese contenido se procesa como parte de la conversación. Para notas con información sensible, vale la pena pensarlo dos veces antes de pedirle a Claude que las lea o las resuma.

¿Para qué sirve esto en el día a día?

Más allá de la prueba inicial, esto es lo que más uso:

Gestión de conocimiento personal

  • Buscar notas antiguas por tema en lugar de scrollear
  • Resumir apuntes de reuniones dispersos en varias notas
  • Consolidar ideas sueltas en una sola nota organizada

Escritura técnica

  • Crear borradores rápidos de artículos o documentación
  • Organizar hallazgos de una investigación a medida que avanzo
  • Generar listas de tareas a partir de una conversación

Homelab y operaciones

  • Consultar runbooks que tengo guardados en Notas sin cambiar de app
  • Dejar registro de cambios de configuración justo después de hacerlos
  • Documentar incidentes o troubleshooting mientras los resuelvo

La ganancia real, en los tres casos, es no tener que salir del chat para anotar o consultar algo.

Cierre

Esta es apenas una de las integraciones posibles con MCP. El mismo patrón —servidor MCP más cliente MCP— aplica para conectar Claude con Gmail, Google Drive, Slack, bases de datos, y en general cualquier herramienta que tenga (o le construyan) un servidor MCP propio. Si te interesa, en próximas entradas cuento otras integraciones que tengo corriendo.