Apple Notes MCP Server

Servidor MCP de Apple Notes

El servidor MCP de Apple Notes es un servidor de Protocolo de Contexto de Modelo que permite una interacción fluida con Apple Notes mediante lenguaje natural. ¡Crea, busca y recupera notas fácilmente con 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 funciones 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 iCloud Notes ☁️

🚀 Primeros pasos

Prerrequisitos

1. macOS con la aplicación Apple Notes configurada
2. Node.js (versión 20.0.0 o superior)
3. Administrador de paquetes de hilo

Instalación

1. Clonar el repositorio:
   git clone https://github.com/Siddhant-K-code/mcp-apple-notes.git cd mcp-apple-notes
2. Instalar dependencias:
   yarn install
3. Construir el proyecto:
   yarn build
4. Iniciar el servidor:
   yarn start
5. Configurar Claude Desktop. Actualizar claude_desktop_config.json con:
   { "mcpServers": { "apple-notes": { "command": "yarn", "args": ["start"], "cwd": "/path/to/mcp-apple-notes" } } }

   Nota: Reemplace /path/to/mcp-apple-notes con la ruta real de su repositorio clonado. Es posible que deba autorizar el script para acceder a Apple Notes al ejecutar los comandos por primera vez.

Inicialización del servidor MCP

Cuando el servidor se inicie correctamente, verás:

¡El servidor ya está listo para gestionar tus operaciones con notas! 🎉

🛠️ Uso

Herramientas disponibles

1. Crear nota
   • Descripción: Crea una nueva nota en Apple Notes
   • Parámetros:
     { title: string; // The title of the note content: string; // The content of the note tags?: string[]; // Optional tags for the note }
   • Ejemplo de respuesta:
     Note created: My New Note
2. Notas de búsqueda
   • Descripción: Buscar notas por título
   • Parámetros:
     { query: string; // The search query }
   • Ejemplo de respuesta:
     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 }
   • Ejemplo de respuesta:
     [Full content of the note]

📚 Casos de uso de ejemplo

1. Toma de notas rápidas

Crear notas durante reuniones o sesiones de lluvia de ideas:

2. Recuperación de información

Busca notas específicas cuando las necesites:

3. Revisión de contenido

Obtenga el contenido completo de una nota específica:

⚡ Consejos para obtener mejores resultados

• Asegúrate de que tu aplicación Apple Notes esté configurada correctamente con iCloud
• Utilice títulos descriptivos para una mejor capacidad de búsqueda
• Incluya etiquetas relevantes al crear notas para una mejor organización

🔧 Desarrollo

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

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

Contenedor de desarrollo

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

• Entorno TypeScript Node.js
• Más bonito para el formato de código
• Instalación automática de dependencias

📄 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Hecho con ❤️ para usuarios de Apple Notes