Unofficial Dex CRM MCP Server

Instructions

Implementation Reference

• src/tools/reminders.ts:88-104 (handler)

  The handler logic that processes the `dex_update_reminder` request, formats the payload using the `toReminderBody` helper, and performs a PUT request to the Dex API.

  async (args) => {
    try {
      const { lastCompletedAt, nextOccurrenceAt, emailSent, pushNotificationSent, ...base } = args.reminder;
      const result = await dex.put(`/v1/reminders/${args.reminderId}`, {
        reminder: {
          ...toReminderBody(base),
          ...(lastCompletedAt !== undefined && { last_completed_at: toDateTime(lastCompletedAt) }),
          ...(nextOccurrenceAt !== undefined && { next_occurrence_at: toDateTime(nextOccurrenceAt) }),
          ...(emailSent !== undefined && { email_sent: emailSent }),
          ...(pushNotificationSent !== undefined && { push_notification_sent: pushNotificationSent }),
        },
      });
      return toResult(result);
    } catch (error) {
      return toError(error);
    }
  }

• src/tools/reminders.ts:73-87 (schema)

  Zod validation schema for the `dex_update_reminder` tool input.

  {
    reminderId: z.string(),
    reminder: z.object({
      text: z.string().optional().describe("Reminder text / title"),
      dueDate: z.string().optional().describe("Due date — accepts 'YYYY-MM-DD' or full ISO 8601 datetime"),
      dueTime: z.string().optional().describe("Optional due time as ISO 8601 datetime"),
      contactIds: z.array(z.string()).optional().describe("List of contact IDs to link to this reminder"),
      recurrence: z.string().optional().describe("Recurrence pattern (e.g. 'weekly', 'monthly')"),
      isComplete: z.boolean().optional(),
      lastCompletedAt: z.string().optional().describe("ISO 8601 datetime of last completion"),
      nextOccurrenceAt: z.string().optional().describe("ISO 8601 datetime of next occurrence"),
      emailSent: z.boolean().optional(),
      pushNotificationSent: z.boolean().optional(),
    }),
  },

• src/tools/reminders.ts:70-72 (registration)

  Registration of the `dex_update_reminder` tool within the MCP server.

  server.tool(
    "dex_update_reminder",
    "Update a reminder by ID. Modify text, due date/time, linked contacts, recurrence, completion status, and notification flags.",