mybooks

Query and manage a MyBooks library via its REST API.

190|24|Updated Oct 10, 2025
One-click install
npx skills add https://github.com/PoxenStudio/mybooks --skill mybooks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mybooks
Source: https://github.com/PoxenStudio/mybooks/tree/main/skills/mybooks
Command: npx skills add https://github.com/PoxenStudio/mybooks --skill mybooks

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

Automates interaction with a MyBooks REST API to query, manage, and synchronize a personal library.

Core Features & Use Cases

  • Retrieve user and library statistics, search books, view book details, and manage reading status.
  • Upload ebooks, add physical books via ISBN, and push books to devices or email.
  • Automate workflows by scripting API calls with environment-based authentication.

Quick Start

Configure the environment variables MYBOOKS_HOST, MYBOOKS_USER, and MYBOOKS_PASSWORD, then run the mybooks_api.py script with a tool name and JSON arguments.

Frequently Asked Questions about mybooks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I automate REST API calls to manage my personal book library?

You can automate book library management by running Python scripts that call the MyBooks REST API to query statistics, search books, and manage reading status automatically. It handles session authentication and retries on expiry.

What environment variables do I need to query library statistics via the API?

To query library statistics via the API, you need to configure three environment variables: MYBOOKS_HOST, MYBOOKS_USER, and MYBOOKS_PASSWORD. These credentials allow the script to automatically sign in and access your library data.

Can I upload ebooks and add physical books by ISBN through an API?

Yes, you can upload ebooks and add physical books by ISBN through the API. The automation script supports ebook uploads, ISBN-based physical book additions, and pushing books to registered devices or email addresses.

Does the Python requests library support automatic session retry on expiry?

The Python requests library is used to maintain sessions, and this automation script automatically signs in and retries on session expiry. This ensures uninterrupted API calls when querying book details or updating metadata.

What's the best way to push books to a device or email using a REST API?

The best way to push books to a device or email is to use the API's dedicated endpoint via the Python script, passing the book identifier and target destination as JSON arguments to the automation tool.

Why does my API session expire when updating book metadata?

API sessions expire after a set timeout period, but the script automatically detects session expiry during metadata updates and re-authenticates using your configured environment variables to retry the request successfully.