radarr_get_movies
Retrieve all movies from your Radarr media library to view your collection, monitor availability, or manage content across your media server.
Instructions
Get all movies in Radarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:1188-1209 (handler)Tool handler that verifies Radarr configuration, fetches movies using RadarrClient.getMovies(), summarizes key fields (id, title, year, status, hasFile, size, monitored, studio), formats as JSON, and returns text content response.
case "radarr_get_movies": { if (!clients.radarr) throw new Error("Radarr not configured"); const movies = await clients.radarr.getMovies(); return { content: [{ type: "text", text: JSON.stringify({ count: movies.length, movies: movies.map(m => ({ id: m.id, title: m.title, year: m.year, status: m.status, hasFile: m.hasFile, sizeOnDisk: formatBytes(m.sizeOnDisk), monitored: m.monitored, studio: m.studio, })), }, null, 2), }], }; } - src/arr-client.ts:142-181 (schema)TypeScript interface Movie defining the structure of movie data returned from Radarr API /movie endpoint, used in RadarrClient.getMovies() return type.
export interface Movie { id: number; title: string; sortTitle: string; sizeOnDisk: number; status: string; overview: string; inCinemas: string; physicalRelease: string; digitalRelease: string; images: Array<{ coverType: string; url: string }>; website: string; year: number; hasFile: boolean; youTubeTrailerId: string; studio: string; path: string; qualityProfileId: number; monitored: boolean; minimumAvailability: string; isAvailable: boolean; folderName: string; runtime: number; cleanTitle: string; imdbId: string; tmdbId: number; titleSlug: string; genres: string[]; tags: number[]; added: string; ratings: { votes: number; value: number }; movieFile?: { id: number; relativePath: string; path: string; size: number; dateAdded: string; quality: { quality: { id: number; name: string } }; }; } - src/index.ts:283-289 (registration)Tool registration in TOOLS array (conditional on RADARR_URL/API_KEY env vars), defining name 'radarr_get_movies', description, and empty input schema (no parameters required).
name: "radarr_get_movies", description: "Get all movies in Radarr library", inputSchema: { type: "object" as const, properties: {}, required: [], }, - src/arr-client.ts:678-683 (helper)RadarrClient.getMovies() helper method that performs authenticated API GET request to Radarr's /api/v3/movie endpoint and returns array of Movie objects.
/** * Get all movies */ async getMovies(): Promise<Movie[]> { return this['request']<Movie[]>('/movie'); }