create_reminder

Lembretes e Microsoft To Do · macOS

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Cria um lembrete no Reminders.app. Sem confirm=true retorna uma prévia do título, da data de vencimento, das notas, da lista, da prioridade e da repetição e não cria nada. Para que ele se repita, passe `recurrence` (daily/weekly/monthly/yearly) com um due_date. Um due_date com data mas sem hora define o vencimento sem alarme, então o Lembretes não notificará; inclua uma hora para receber uma notificação.

Entradas obrigatórias

title

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

Esquema técnico canónico em inglês — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to create",
      "type": "boolean"
    },
    "due_date": {
      "description": "ISO 8601 date (optional)",
      "type": "string"
    },
    "list_name": {
      "description": "Reminder list name (optional)",
      "type": "string"
    },
    "notes": {
      "description": "Notes (optional)",
      "type": "string"
    },
    "priority": {
      "description": "Priority: none | low | medium | high (optional)",
      "enum": [
        "none",
        "low",
        "medium",
        "high"
      ],
      "type": "string"
    },
    "recurrence": {
      "description": "Make it a repeating reminder: 'daily', 'weekly', 'monthly', or 'yearly' (optional; omit or 'none' for a one-time reminder). A repeating reminder needs a due date.",
      "enum": [
        "daily",
        "weekly",
        "monthly",
        "yearly",
        "none"
      ],
      "type": "string"
    },
    "recurrence_count": {
      "description": "Total number of occurrences (optional). Mutually exclusive with recurrence_until; if neither is given it repeats indefinitely. Needs recurrence.",
      "type": "integer"
    },
    "recurrence_interval": {
      "description": "Repeat every N periods (optional, default 1 — e.g. recurrence='weekly' + recurrence_interval=2 = every 2 weeks). Needs recurrence.",
      "type": "integer"
    },
    "recurrence_until": {
      "description": "ISO 8601 date the repetition stops on (optional; takes precedence over recurrence_count). Needs recurrence.",
      "type": "string"
    },
    "title": {
      "description": "Reminder title",
      "type": "string"
    }
  },
  "required": [
    "title"
  ],
  "type": "object"
}

Exemplo documental

Exemplo de documentação para create_reminder. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

{
  "confirm": false,
  "title": "Planning meeting"
}