Apple Reminders

Interaja com o Apple Reminders no macOS.

GitHub
32

Documentação

MCP Apple Reminders

Um servidor Model Context Protocol (MCP) para interagir com Apple Reminders no macOS.

Recursos

  • Gerenciamento de Listas: Veja todas as listas de lembretes no seu aplicativo Apple Reminders
  • Recuperação de Lembretes: Obtenha todos os lembretes de uma lista específica
  • Criar Lembretes: Crie novos lembretes com títulos, datas de vencimento e notas
  • Concluir Lembretes: Marque lembretes como concluídos
  • Excluir Lembretes: Remova lembretes das suas listas
  • Tratamento de Datas: Tratamento adequado de formatos de data ISO para datas de vencimento

Configuração

Uso com Claude Desktop

Adicione isso ao seu claude_desktop_config.json:

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

NPX (Em breve)

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

API

O servidor expõe as seguintes ferramentas MCP para interagir com Apple Reminders:

getLists

Retorna todas as listas de lembretes.

getReminders

Retorna lembretes de uma lista específica.

  • Parâmetros:
    • listName (obrigatório): O nome da lista de lembretes

createReminder

Cria um novo lembrete.

  • Parâmetros:
    • listName (obrigatório): O nome da lista de lembretes
    • title (obrigatório): O título do lembrete
    • dueDate (opcional): A data de vencimento do lembrete (formato ISO: "YYYY-MM-DDTHH:MM:SS.sssZ")
    • notes (opcional): Notas para o lembrete

completeReminder

Marca um lembrete como concluído.

  • Parâmetros:
    • listName (obrigatório): O nome da lista de lembretes
    • reminderName (obrigatório): O nome do lembrete a ser concluído

deleteReminder

Exclui um lembrete.

  • Parâmetros:
    • listName (obrigatório): O nome da lista de lembretes
    • reminderName (obrigatório): O nome do lembrete a ser excluído

Como Funciona

Este servidor MCP usa AppleScript para interagir com o aplicativo Apple Reminders no macOS. Ele fornece uma interface padronizada para assistentes de IA gerenciarem lembretes por meio do Model Context Protocol.

Desenvolvimento

Este projeto usa TypeScript e o MCP SDK. Para estender a funcionalidade, modifique as ferramentas em src/index.ts e as funções AppleScript em src/reminders.ts.

Requisitos

  • macOS (obrigatório para integração com Apple Reminders)
  • Node.js 16+
  • Aplicativo Apple Reminders configurado com pelo menos uma lista

Licença

MIT