---
title: "Get my library"
method: GET
path: "/api/agent/get_my_library"
tags: ["library"]
---

# Get my library

`GET /api/agent/get_my_library`

## Request

- Base URL: `https://api.siftivo.com`
- URL: `https://api.siftivo.com/api/agent/get_my_library`
- Auth: none required

The signed-in reader's Siftivo shelves: what they want to read, are reading, finished or did not finish, with their ratings, progress and private notes. Suits "what am I reading", "what is on my to-read list" and "what have I finished". Filter to one shelf with status. Needs a linked Siftivo account.

Not callable on this REST surface. It acts on the signed-in reader's own library, and this path answers 401 to every caller regardless of credentials. Reach it over MCP at https://api.siftivo.com/mcp, which runs the OAuth handshake.

## Query parameters

- `status` 'NOT_STARTED' | 'READING' | 'FINISHED' | 'DNF': Filter to one shelf. Omit for the whole library.

## Other responses

- `401`: Always. This tool is reachable over MCP only; see the description for the endpoint that serves it.

---

[API](https://skmtc.dev/siftivo/apis/siftivo-agent-api.md) · [All operations](https://skmtc.dev/siftivo/apis/siftivo-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/siftivo/apis/siftivo-agent-api/revisions/2b85acb5f7c8?raw)