MCP *arr Server

Instructions

Implementation Reference

• src/index.ts:1252-1261 (handler)

  Handler for radarr_get_calendar tool: checks if Radarr client is configured, computes start/end dates from optional 'days' parameter (default 30), calls clients.radarr.getCalendar, and returns JSON stringified calendar data.
  case "radarr_get_calendar": { if (!clients.radarr) throw new Error("Radarr not configured"); const days = (args as { days?: number })?.days || 30; const start = new Date().toISOString().split('T')[0]; const end = new Date(Date.now() + days * 24 * 60 * 60 * 1000).toISOString().split('T')[0]; const calendar = await clients.radarr.getCalendar(start, end); return { content: [{ type: "text", text: JSON.stringify(calendar, null, 2) }], }; }
• src/index.ts:314-327 (registration)

  Tool registration for 'radarr_get_calendar' including name, description, and input schema (optional 'days' number parameter).
  { name: "radarr_get_calendar", description: "Get upcoming movie releases from Radarr", inputSchema: { type: "object" as const, properties: { days: { type: "number", description: "Number of days to look ahead (default: 30)", }, }, required: [], }, },
• src/index.ts:314-327 (schema)

  Input schema definition for radarr_get_calendar tool: object with optional 'days' property of type number.
  { name: "radarr_get_calendar", description: "Get upcoming movie releases from Radarr", inputSchema: { type: "object" as const, properties: { days: { type: "number", description: "Number of days to look ahead (default: 30)", }, }, required: [], }, },
• src/arr-client.ts:500-505 (helper)

  ArrClient.getCalendar method: constructs /calendar API endpoint with optional start/end date query params and makes authenticated API request to the *arr service.
  const params = new URLSearchParams(); if (start) params.append('start', start); if (end) params.append('end', end); const query = params.toString() ? `?${params.toString()}` : ''; return this.request<unknown[]>(`/calendar${query}`); }
• src/arr-client.ts:673-676 (helper)

  RadarrClient class definition extending ArrClient with service name 'radarr'.
  export class RadarrClient extends ArrClient { constructor(config: ArrConfig) { super('radarr', config); }