bookshelf-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BOOKSHELF_URL | Yes | The base URL of the Bookshelf instance, e.g. http://your-bookshelf-host:8787 | |
| BOOKSHELF_API_KEY | No | API key for authentication via X-Api-Key header. Optional for startup but required for all API endpoints. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| bookshelf_list_authorC | List author. |
| bookshelf_create_authorB | Create author. WRITE: this modifies your Bookshelf instance. |
| bookshelf_update_authorC | Update author. Query params: moveFiles. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_authorB | Delete author. Query params: deleteFiles, addImportListExclusion. DESTRUCTIVE: this deletes data. |
| bookshelf_get_authorA | Fetch a single author by id. |
| bookshelf_bulk_update_authorC | Bulk update author editor. WRITE: this modifies your Bookshelf instance. |
| bookshelf_bulk_delete_authorC | Bulk delete author editor. DESTRUCTIVE: this deletes data. |
| bookshelf_lookup_authorA | Search the metadata provider for authors by term. |
| bookshelf_list_system_backupA | List system backup. |
| bookshelf_delete_system_backupB | Delete system backup. DESTRUCTIVE: this deletes data. |
| bookshelf_restore_backupD | Create system backup restore. WRITE: this modifies your Bookshelf instance. |
| bookshelf_restore_backup_uploadC | Create system backup restore upload. WRITE: this modifies your Bookshelf instance. |
| bookshelf_list_blocklistC | List blocklist. Query params: page, pageSize, sortKey, sortDirection. |
| bookshelf_delete_blocklistC | Delete blocklist. DESTRUCTIVE: this deletes data. |
| bookshelf_bulk_delete_blocklistC | Bulk delete blocklist bulk. DESTRUCTIVE: this deletes data. |
| bookshelf_list_bookD | List book. Query params: authorId, bookIds, titleSlug, includeAllAuthorBooks. |
| bookshelf_create_bookC | Create book. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_book_overviewB | Fetch a single book overview by id. |
| bookshelf_update_bookC | Update book. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_bookB | Delete book. Query params: deleteFiles, addImportListExclusion. DESTRUCTIVE: this deletes data. |
| bookshelf_get_bookA | Fetch a single book by id. |
| bookshelf_update_books_monitoredA | Set the monitored state of books in bulk. Body is a BooksMonitoredResource with bookIds and monitored. |
| bookshelf_bulk_update_bookC | Bulk update book editor. WRITE: this modifies your Bookshelf instance. |
| bookshelf_bulk_delete_bookC | Bulk delete book editor. DESTRUCTIVE: this deletes data. |
| bookshelf_list_bookfileC | List bookfile. Query params: authorId, bookFileIds, bookId, unmapped. |
| bookshelf_update_bookfileC | Update bookfile. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_bookfileC | Delete bookfile. DESTRUCTIVE: this deletes data. |
| bookshelf_get_bookfileA | Fetch a single bookfile by id. |
| bookshelf_bulk_update_bookfileB | Bulk update bookfile editor. WRITE: this modifies your Bookshelf instance. |
| bookshelf_bulk_delete_bookfileC | Bulk delete bookfile bulk. DESTRUCTIVE: this deletes data. |
| bookshelf_lookup_bookC | Search the metadata provider for books by term. |
| bookshelf_add_books_to_shelfB | Add the given books to a Goodreads/Hardcover shelf. Body is a BookshelfResource with bookshelfId and bookIds. |
| bookshelf_list_calendarC | List calendar. Query params: start, end, unmonitored, includeAuthor. |
| bookshelf_get_calendarB | Fetch a single calendar by id. |
| bookshelf_run_commandA | Run a Bookshelf command (body is a CommandResource with a |
| bookshelf_list_commandC | List command. |
| bookshelf_delete_commandC | Delete command. DESTRUCTIVE: this deletes data. |
| bookshelf_get_commandA | Fetch a single command by id. |
| bookshelf_list_customfilterC | List customfilter. |
| bookshelf_create_customfilterB | Create customfilter. WRITE: this modifies your Bookshelf instance. |
| bookshelf_update_customfilterC | Update customfilter. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_customfilterC | Delete customfilter. DESTRUCTIVE: this deletes data. |
| bookshelf_get_customfilterA | Fetch a single customfilter by id. |
| bookshelf_create_customformatC | Create customformat. WRITE: this modifies your Bookshelf instance. |
| bookshelf_list_customformatC | List customformat. |
| bookshelf_update_customformatB | Update customformat. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_customformatB | Delete customformat. DESTRUCTIVE: this deletes data. |
| bookshelf_get_customformatA | Fetch a single customformat by id. |
| bookshelf_get_customformat_schemaC | List customformat schema. |
| bookshelf_list_wanted_cutoffC | List wanted cutoff. Query params: page, pageSize, sortKey, sortDirection, includeAuthor, monitored. |
| bookshelf_get_wanted_cutoffA | Fetch a single wanted cutoff by id. |
| bookshelf_create_delayprofileC | Create delayprofile. WRITE: this modifies your Bookshelf instance. |
| bookshelf_list_delayprofileB | List delayprofile. |
| bookshelf_delete_delayprofileC | Delete delayprofile. DESTRUCTIVE: this deletes data. |
| bookshelf_update_delayprofileC | Update delayprofile. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_delayprofileA | Fetch a single delayprofile by id. |
| bookshelf_reorder_delayprofileC | Update delayprofile reorder. Query params: afterId. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_developmentC | List config development. |
| bookshelf_update_config_developmentC | Update config development. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_development_by_idA | Fetch a single config development by id. |
| bookshelf_get_diskspaceB | List diskspace. |
| bookshelf_list_downloadclientC | List downloadclient. |
| bookshelf_create_downloadclientA | Create downloadclient. Query params: forceSave. WRITE: this modifies your Bookshelf instance. |
| bookshelf_update_downloadclientC | Update downloadclient. Query params: forceSave. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_downloadclientC | Delete downloadclient. DESTRUCTIVE: this deletes data. |
| bookshelf_get_downloadclientA | Fetch a single downloadclient by id. |
| bookshelf_bulk_update_downloadclientC | Bulk update downloadclient bulk. WRITE: this modifies your Bookshelf instance. |
| bookshelf_bulk_delete_downloadclientC | Bulk delete downloadclient bulk. DESTRUCTIVE: this deletes data. |
| bookshelf_get_downloadclient_schemaB | List downloadclient schema. |
| bookshelf_test_downloadclientD | Create downloadclient test. Query params: forceTest. WRITE: this modifies your Bookshelf instance. |
| bookshelf_test_all_downloadclientC | Create downloadclient testall. WRITE: this modifies your Bookshelf instance. |
| bookshelf_action_downloadclientD | Create downloadclient action. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_downloadclientC | List config downloadclient. |
| bookshelf_update_config_downloadclientD | Update config downloadclient. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_downloadclient_by_idB | Fetch a single config downloadclient by id. |
| bookshelf_list_editionC | List edition. Query params: bookId. |
| bookshelf_list_filesystemC | List filesystem. Query params: path, includeFiles, allowFoldersWithoutTrailingSlashes. |
| bookshelf_list_filesystem_typeC | List filesystem type. Query params: path. |
| bookshelf_list_filesystem_mediafilesC | List filesystem mediafiles. Query params: path. |
| bookshelf_get_healthC | List health. |
| bookshelf_list_historyC | List history. Query params: page, pageSize, sortKey, sortDirection, includeAuthor, includeBook, eventType, bookId, downloadId. |
| bookshelf_list_history_sinceC | List history since. Query params: date, eventType, includeAuthor, includeBook. |
| bookshelf_list_history_authorD | List history author. Query params: authorId, bookId, eventType, includeAuthor, includeBook. |
| bookshelf_mark_history_failedA | Mark a history event as failed and trigger a re-search. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_hostC | List config host. |
| bookshelf_update_config_hostB | Update config host. WRITE: this modifies your Bookshelf instance. |
| bookshelf_get_config_host_by_idB | Fetch a single config host by id. |
| bookshelf_list_importlistB | List importlist. |
| bookshelf_create_importlistC | Create importlist. Query params: forceSave. WRITE: this modifies your Bookshelf instance. |
| bookshelf_update_importlistC | Update importlist. Query params: forceSave. WRITE: this modifies your Bookshelf instance. |
| bookshelf_delete_importlistC | Delete importlist. DESTRUCTIVE: this deletes data. |
| bookshelf_get_importlistB | Fetch a single importlist by id. |
| bookshelf_bulk_update_importlistD | Bulk update importlist bulk. WRITE: this modifies your Bookshelf instance. |
| bookshelf_bulk_delete_importlistC | Bulk delete importlist bulk. DESTRUCTIVE: this deletes data. |
| bookshelf_get_importlist_schemaA | List importlist schema. |
| bookshelf_test_importlistC | Create importlist test. Query params: forceTest. WRITE: this modifies your Bookshelf instance. |
| bookshelf_test_all_importlistC | Create importlist testall. WRITE: this modifies your Bookshelf instance. |
| bookshelf_action_importlistC | Create importlist action. WRITE: this modifies your Bookshelf instance. |
| bookshelf_list_importlistexclusionA | List importlistexclusion. |
| bookshelf_create_importlistexclusionC | Create importlistexclusion. WRITE: this modifies your Bookshelf instance. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/SavageCore/bookshelf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server