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. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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/arr-mcps/bookshelf-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server