Apple Reminders

MCP Apple Reminders

Un servidor de Model Context Protocol (MCP) para interactuar con Apple Reminders en macOS.

Características

• Gestión de listas: Ver todas las listas de recordatorios en tu app Apple Reminders
• Recuperación de recordatorios: Obtener todos los recordatorios de una lista específica
• Crear recordatorios: Crear nuevos recordatorios con títulos, fechas de vencimiento y notas
• Completar recordatorios: Marcar recordatorios como completados
• Eliminar recordatorios: Eliminar recordatorios de tus listas
• Manejo de fechas: Manejo adecuado de formatos de fecha ISO para fechas de vencimiento

Configuración

Uso con Claude Desktop

Agrega esto a tu claude_desktop_config.json:

{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/path/to/mcp-apple-reminders/dist/index.js"
      ]
    }
  }
}

NPX (Próximamente)

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

API

El servidor expone las siguientes herramientas MCP para interactuar con Apple Reminders:

getLists

Devuelve todas las listas de recordatorios.

getReminders

Devuelve los recordatorios de una lista específica.

• Parámetros:
  • listName (obligatorio): El nombre de la lista de recordatorios

createReminder

Crea un nuevo recordatorio.

• Parámetros:
  • listName (obligatorio): El nombre de la lista de recordatorios
  • title (obligatorio): El título del recordatorio
  • dueDate (opcional): La fecha de vencimiento del recordatorio (formato ISO: "YYYY-MM-DDTHH:MM:SS.sssZ")
  • notes (opcional): Notas para el recordatorio

completeReminder

Marca un recordatorio como completado.

• Parámetros:
  • listName (obligatorio): El nombre de la lista de recordatorios
  • reminderName (obligatorio): El nombre del recordatorio a completar

deleteReminder

Elimina un recordatorio.

• Parámetros:
  • listName (obligatorio): El nombre de la lista de recordatorios
  • reminderName (obligatorio): El nombre del recordatorio a eliminar

Cómo funciona

Este servidor MCP usa AppleScript para interactuar con la app Apple Reminders en macOS. Proporciona una interfaz estandarizada para que los asistentes de IA gestionen recordatorios a través del Model Context Protocol.

Desarrollo

Este proyecto usa TypeScript y el SDK de MCP. Para ampliar la funcionalidad, modifica las herramientas en src/index.ts y las funciones de AppleScript en src/reminders.ts.

Requisitos

• macOS (obligatorio para la integración con Apple Reminders)
• Node.js 16+
• App Apple Reminders configurada con al menos una lista

Licencia

MIT