upload_book
Upload audio files to create a new book in an Audiobookshelf library, including cover or ebook, by specifying library, folder, title, and file paths.
Instructions
Upload audio files as a new book, creating the library item.
This is how a book that is not already on the server gets in. Audiobookshelf has no wishlist and cannot fetch a book from a title alone: the files have to exist somewhere this machine can read, and they are sent to the server here.
Args:
library_id: Target library, from list_libraries.
folder_id: Folder within that library, from the library's folders.
title: Book title, which becomes the item name and its folder name.
files: Absolute paths to the audio files on this machine, plus any
cover, ebook or PDF to sit alongside them.
author: Author name, used for the folder structure.
series: Series name, if it belongs to one.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"library_id": "<library_id>",
"folder_id": "<folder_id>",
"title": "<title>",
"files": "<files>"
},
"name": "upload_book"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| files | Yes | ||
| title | Yes | ||
| author | No | ||
| series | No | ||
| folder_id | Yes | ||
| library_id | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |