readarr_get_authors
Retrieve all authors stored in your Readarr library to manage book collections and monitor author-based content across media services.
Instructions
Get all authors in Readarr library
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/index.ts:1423-1442 (handler)Executes the tool by calling ReadarrClient.getAuthors(), formats summary with count, id, name, status, books stats, size, monitored statuscase "readarr_get_authors": { if (!clients.readarr) throw new Error("Readarr not configured"); const authors = await clients.readarr.getAuthors(); return { content: [{ type: "text", text: JSON.stringify({ count: authors.length, authors: authors.map(a => ({ id: a.id, authorName: a.authorName, status: a.status, books: a.statistics?.bookFileCount + '/' + a.statistics?.totalBookCount, sizeOnDisk: formatBytes(a.statistics?.sizeOnDisk || 0), monitored: a.monitored, })), }, null, 2), }], }; }
- src/index.ts:443-450 (registration)Registers the tool in the TOOLS array if Readarr client is configuredname: "readarr_get_authors", description: "Get all authors in Readarr library", inputSchema: { type: "object" as const, properties: {}, required: [], }, },
- src/index.ts:445-449 (schema)Input schema for the tool (no parameters required)inputSchema: { type: "object" as const, properties: {}, required: [], },
- src/arr-client.ts:841-843 (helper)ReadarrClient.getAuthors() makes authenticated API request to Readarr /author endpointasync getAuthors(): Promise<Author[]> { return this['request']<Author[]>('/author'); }
- src/arr-client.ts:838-843 (helper)Full ReadarrClient.getAuthors() method including JSDoc, returns array of Author objects from API/** * Get all authors */ async getAuthors(): Promise<Author[]> { return this['request']<Author[]>('/author'); }