Apple Notes

[!Caution] No se mantiene activamente. ¡Úsalo bajo tu propio riesgo!

📝 Servidor MCP de Apple Notes

Servidor MCP de Apple Notes es un servidor del Protocolo de Contexto de Modelo (MCP) que permite una interacción fluida con Apple Notes mediante lenguaje natural. ¡Crea, busca y recupera notas sin esfuerzo usando Claude u otros asistentes de IA! 🎉

🎯 Características

• Crear notas: Crea rápidamente nuevas notas con títulos, contenido y etiquetas 📝
• Buscar notas: Encuentra notas usando potentes capacidades de búsqueda 🔍
• Recuperar contenido: Obtén el contenido completo de cualquier nota por su título 📖
• Integración con iCloud: Funciona directamente con tu cuenta de Notas de iCloud ☁️

🚀 Primeros pasos

Requisitos previos

1. macOS con la app Notas de Apple configurada
2. Node.js (versión 20.0.0 o superior)
3. Gestor de paquetes Yarn

Instalación

1. Clona el repositorio:

   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git
   cd mcp-apple-notes
   

2. Instala las dependencias:

   yarn install
   

3. Compila el proyecto:

   yarn build
   

4. Inicia el servidor:

   yarn start
   

5. Configura Claude Desktop. Actualiza tu claude_desktop_config.json con:

   {
     "mcpServers": {
       "apple-notes": {
         "command": "yarn",
         "args": ["start"],
         "cwd": "/path/to/mcp-apple-notes"
       }
     }
   }
   

   Nota: Reemplaza /path/to/mcp-apple-notes con la ruta real a tu repositorio clonado. Es posible que debas autorizar el script para acceder a Notas de Apple la primera vez que ejecutes los comandos.

Inicialización del servidor MCP

Cuando el servidor se inicie correctamente, verás:

Starting Apple Notes MCP server.

¡El servidor ya está listo para manejar tus operaciones de notas! 🎉

🛠️ Uso

Herramientas disponibles

1. Crear nota

   • Descripción: Crea una nueva nota en Notas de Apple
   • Parámetros:

     {
       title: string;      // The title of the note
       content: string;    // The content of the note
       tags?: string[];    // Optional tags for the note
     }
     

   • Respuesta de ejemplo:

     Note created: My New Note
     

2. Buscar notas

   • Descripción: Busca notas por título
   • Parámetros:

     {
       query: string; // The search query
     }
     

   • Respuesta de ejemplo:

     Meeting Notes
     Shopping List
     Ideas for Project
     

3. Obtener contenido de la nota

   • Descripción: Recupera el contenido completo de una nota específica
   • Parámetros:

     {
       title: string; // The exact title of the note
     }
     

   • Respuesta de ejemplo:

     [Full content of the note]
     

📚 Ejemplos de casos de uso

1. Toma de notas rápida

Crea notas durante reuniones o sesiones de lluvia de ideas:

{
"title": "Team Meeting Notes",
"content": "Discussion points:\n1. Project timeline\n2. Resource allocation",
"tags": ["meetings", "work"]
}

2. Recuperación de información

Busca notas específicas cuando las necesites:

{
"query": "meeting"
}

3. Revisión de contenido

Obtén el contenido completo de una nota específica:

{
"title": "Team Meeting Notes"
}

⚡ Consejos para mejores resultados

• Asegúrate de que la app Notas de Apple esté correctamente configurada con iCloud
• Usa títulos descriptivos para una mejor búsqueda
• Incluye etiquetas relevantes al crear notas para una mejor organización

🔧 Desarrollo

El proyecto usa TypeScript y sigue patrones modernos de módulos ES. Archivos clave:

• src/index.ts: Implementación principal del servidor
• src/services/appleNotesManager.ts: Funcionalidad principal de gestión de notas
• src/utils/applescript.ts: Utilidades de integración con AppleScript

Contenedor de desarrollo

Se proporciona una configuración de contenedor de desarrollo para usuarios de VS Code, que ofrece:

• Entorno de TypeScript Node.js
• Prettier para formateo de código
• Instalación automática de dependencias

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT; consulta el archivo LICENSE para más detalles.

---

Hecho con ❤️ para los usuarios de Notas de Apple