radarr_get_movies
Retrieve all movies from your Radarr media library to view your collection and manage content.
Instructions
Get all movies in Radarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:282-290 (registration)Registration of the MCP tool 'radarr_get_movies' in the TOOLS array if Radarr client is configured.{ name: "radarr_get_movies", description: "Get all movies in Radarr library", inputSchema: { type: "object" as const, properties: {}, required: [], }, },
- src/index.ts:1188-1209 (handler)Main handler function for the 'radarr_get_movies' tool call: checks configuration, calls RadarrClient.getMovies(), formats and returns summary of movies.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:681-683 (helper)RadarrClient.getMovies() helper method that performs the API request to fetch all movies from Radarr (/movie endpoint).async getMovies(): Promise<Movie[]> { return this['request']<Movie[]>('/movie'); }
- src/arr-client.ts:142-181 (schema)TypeScript interface defining the structure of Movie objects returned from Radarr API.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 } }; }; }